Developer Documentation

API-Dokumentation

Integrieren Sie Hue Write mit unserer REST-API in Ihre Anwendungen

API access is available on the Max plan. Create and manage keys in your developer settings.

API-Übersicht

Die Hue Write-API ermöglicht es Ihnen, KI-generierten Text programmatisch zu humanisieren. Dieser Endpunkt ist ausschließlich für Max-Plan-Abonnenten verfügbar.

API-Endpunkt

POSThttps://huewrite.com/api/v1/humanize

The endpoint accepts a JSON body and streams the humanized text back as text/plain. Available exclusively on the Max plan.

Authentifizierung

Authenticate every request with your secret API key, sent as a Bearer token.

Authorization header

Authorization: Bearer hue_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Create and manage keys on the Developer page. Your full key is shown only once at creation — store it securely.
Keys begin with hue_ and expire 90 days after creation.
Keys are revoked automatically if your plan is downgraded from Max. Never expose a key in client-side code.

Anfragekörper

Die API akzeptiert JSON-Anfragen und gibt Streaming-Textantworten zurück.

Parameter	Type	Description
textRequired	string	The AI-generated text to humanize. Up to 3,000 words per request on the Max plan.
toneOptional	string	Writing style. One of `standard`, `professional`, `friendly`, `formal`, `casual`, `academic`, or `creative`.Default: `standard`
modelVersionOptional	string	Humanization model. One of `v4beta`, `v4`, `v3.5`, `v3`, or `v2`.Default: `v4beta`
ultraModeOptional	boolean	Enable Ultra Mode for higher-quality, more thorough humanization.Default: `false`
isRehumanizationOptional	boolean	Mark the request as a rehumanization of a previous result. The Max plan includes 3 free rehumanizations per task.Default: `false`
teamIdOptional	string	Optional team context. Draws credits from the team owner's balance (requires team API access to be enabled).

Example request body

JSON

{
  "text": "Your AI-generated text here",
  "tone": "standard",
  "modelVersion": "v4beta",
  "ultraMode": false,
  "isRehumanization": false
}

Antwort

On success the humanized text is streamed back chunk by chunk. Errors return a JSON object.

200 OKtext/plain; charset=utf-8 — read the stream incrementally.

ErrorsJSON body with an error code and a human-readable message.

JSON

{
  "error": "rate_limit_exceeded",
  "message": "API key rate limit exceeded. Please slow down.",
  "resetAt": "2026-06-20T12:00:00.000Z"
}

Status	Code	Meaning
400	validation_error	Invalid input — e.g. the text is too short or exceeds your plan's per-request word limit.
401	unauthorized	The API key is missing, malformed, invalid, revoked, or expired.
403	forbidden	Your plan doesn't include API access, or you've run out of credits.
429	rate_limit_exceeded	Too many requests. Check the Retry-After and X-RateLimit-Reset response headers.
500	internal_error	An unexpected error occurred on our side. Retry with backoff.

Rate-limited responses include Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.

Code-Beispiele

Starten Sie schnell mit diesen Code-Beispielen in gängigen Programmiersprachen.

cURL

curl -X POST https://huewrite.com/api/v1/humanize \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer hue_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "text": "Your AI-generated text here",
    "tone": "standard",
    "modelVersion": "v4beta"
  }'

Ratenlimits und Nutzung

API-Anfragen unterliegen denselben Ratenlimits und dem Kreditverbrauch wie die Weboberfläche:

Rate limit

30 / min

Requests per API key

Concurrency

Simultaneous requests

Per request

3,000

Words (Max plan)

Monthly quota

90,000

Words / month (Max plan)

Credits

By word

Same as the web app

Key lifetime

90 days

Regenerate when needed

Brauchen Sie Hilfe?

Wenn Sie Fragen haben oder Unterstützung bei der API benötigen, steht Ihnen unser Support-Team gerne zur Verfügung.

Support Kontaktieren