Developer Documentation

Documentación API

Integre Hue Write en sus aplicaciones con nuestra API REST

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

Descripción General de la API

La API de Hue Write le permite humanizar texto generado por IA de forma programática. Este endpoint está disponible exclusivamente para suscriptores del plan Max.

Endpoint de la 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.

Autenticación

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.

Cuerpo de la Solicitud

La API acepta solicitudes JSON y devuelve respuestas de texto 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
}

Respuesta

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.

Ejemplos de Código

Comience rápidamente con estos ejemplos de código en lenguajes de programación populares.

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

Límites de Tasa y Uso

Las solicitudes de API están sujetas a los mismos límites de tasa y consumo de créditos que la interfaz 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

¿Necesita Ayuda?

Si tiene preguntas o necesita asistencia con la API, nuestro equipo de soporte está aquí para ayudar.

Contactar Soporte