API Documentation
Integrate Hue Write into your applications with our REST API
API access is available on the Max plan. Create and manage keys in your developer settings.
Quickstart
The Hue Write API allows you to programmatically humanize AI-generated text. This endpoint is available exclusively for Max plan subscribers.
https://huewrite.com/api/v1/humanize- 1
Create a key
On the Developer page. It's shown once, so store it as
HUEWRITE_API_KEY. - 2
Send your text
POST a JSON body with
textand, optionally, a tone and model. - 3
Read the stream
The humanized text streams back as
text/plain.
curl -X POST https://huewrite.com/api/v1/humanize \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $HUEWRITE_API_KEY" \
-d '{
"text": "Your AI-generated text here",
"tone": "standard",
"modelVersion": "v4beta"
}'Authentication
Authenticate every request with your secret API key, sent as a Bearer token.
Authorization: Bearer hue_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx- Create and revoke keys on the Developer page. The full key is shown only once, when you create it.
- Keys begin with
hue_and expire 90 days after creation. You can hold up to 10 at a time. - Call the API from your server. Never ship a key in client-side code or commit it to a repository.
Request Body
The API accepts JSON requests and returns streaming text responses.
| Parameter | Type | Description |
|---|---|---|
| textRequired | string | The text to humanize: at least 10 characters, and up to 3,000 words per request on the Max plan. |
| toneOptional | string | Writing style. One of standard, academic, professional, friendly, formal, casual or creative.Default: standard |
| modelVersionOptional | string | Humanization model: v4beta, v3.5 or v3. Newer models enabled for your account are listed, with their value, in the playground on the Developer page.Default: v4beta |
| ultraModeOptional | boolean | Enable Ultra Mode for a more thorough humanization pass.Default: false |
| rewriteLevelOptional | string | How freely the text is rewritten: quality stays closest to the original wording, balanced is the recommended middle and max rewrites the most.Default: balanced |
| polishOptional | boolean | Run a final copy-edit pass over the result. Set to false to skip it.Default: true |
| isRehumanizationOptional | boolean | Humanize the same text again for a different result, without using credits. The text must match an earlier request exactly; the Max plan allows 3 per text.Default: false |
| teamIdOptional | string | Run the request in a team workspace, drawing credits from the team owner. Required when your API access comes from a team rather than your own Max plan. |
Example request body
{
"text": "Your AI-generated text here",
"tone": "standard",
"modelVersion": "v4beta",
"ultraMode": false,
"polish": true
}Response
On success the humanized text streams back chunk by chunk.
text/plain; charset=utf-8- Read the body incrementally to show progress, or wait for it to finish for the whole text.
- Paragraphs are separated by a blank line.
- Credits are charged by the word, the same as in the web app.
Errors
Errors return JSON with a stable error code and a human-readable message.
{
"error": "rate_limit_exceeded",
"message": "API rate limit exceeded. Please slow down.",
"resetAt": "2026-06-20T12:00:00.000Z"
}| Status | Code | Meaning |
|---|---|---|
| 400 | validation_error | The body is invalid, e.g. the text is missing or too short. |
| 400 / 403 | model_unavailable | The model is retired or isn't enabled for your account. |
| 400 | rehumanization_invalid | isRehumanization was set, but the text doesn't match an earlier request. |
| 401 | unauthorized | The key is missing, malformed, revoked or expired, or the account no longer has API access. |
| 403 | insufficient_credits | Not enough word credits left for this text. |
| 403 | rehumanization_limit_exceeded | This text has used all of its rehumanizations. |
| 403 | permission_denied | Your team owner has turned this option off for your account. |
| 429 | rate_limit_exceeded | More than 30 requests in a minute across your account. Wait for the time in the Retry-After header. |
| 429 | concurrent_limit_exceeded | Too many requests running at once. Wait for one to finish. |
| 429 | member_credit_limit_exceeded | You've used your monthly word limit in this team. |
| 500 | internal_error | Something went wrong on our side. Retry with backoff. |
| 504 | processing_timeout | The request took too long to process. Retry, or send shorter text. |
Rate-limited responses include Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.
Code Examples
Get started quickly with these code examples in popular programming languages.
curl -X POST https://huewrite.com/api/v1/humanize \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $HUEWRITE_API_KEY" \
-d '{
"text": "Your AI-generated text here",
"tone": "standard",
"modelVersion": "v4beta"
}'Rate Limits & Usage
API requests use the same word credits and plan limits as the web app.
Rate limit
30 / min
Per account, across all keys
Concurrency
2
Requests at once
Per request
3,000
Words (Max plan)
Monthly quota
90,000
Words / month (Max plan)
Key lifetime
90 days
Create a new key before expiry
Active keys
10
Per account
Need Help?
If you have questions or need assistance with the API, our support team is here to help.