Developer Documentation

Documentação da API

Integre o Hue Write em suas aplicações com nossa API REST

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

Visão Geral da API

A API do Hue Write permite humanizar texto gerado por IA programaticamente. Este endpoint está disponível exclusivamente para assinantes do plano Max.

Endpoint da 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.

Autenticação

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.

Corpo da Requisição

A API aceita requisições JSON e retorna respostas de texto em 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
}

Resposta

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.

Exemplos de Código

Comece rapidamente com estes exemplos de código em linguagens de programação 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"
  }'

Limites de Taxa e Uso

As requisições da API estão sujeitas aos mesmos limites de taxa e consumo de créditos da 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

Precisa de Ajuda?

Se você tiver dúvidas ou precisar de assistência com a API, nossa equipe de suporte está aqui para ajudar.

Contatar Suporte