Developer Documentation

Documentation API

Intégrez Hue Write dans vos applications avec notre API REST

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

Aperçu de l'API

L'API Hue Write vous permet d'humaniser du texte généré par IA de manière programmatique. Ce point de terminaison est disponible exclusivement pour les abonnés du plan Max.

Point de Terminaison API

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.

Authentification

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.

Corps de la Requête

L'API accepte les requêtes JSON et renvoie des réponses textuelles en streaming.

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
}

Réponse

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.

Exemples de Code

Démarrez rapidement avec ces exemples de code dans les langages de programmation populaires.

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"
  }'

Limites de Taux et Utilisation

Les requêtes API sont soumises aux mêmes limites de taux et à la consommation de crédits que l'interface web:

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

Besoin d'Aide?

Si vous avez des questions ou besoin d'assistance avec l'API, notre équipe de support est là pour vous aider.

Contacter le Support