API文档
使用我们的REST API将Huewrite集成到您的应用程序中
API access is available on the Max plan. Create and manage keys in your developer settings.
API概述
Hue Write API允许您以编程方式人性化AI生成的文本。此端点仅供Max计划订阅者使用。
API端点
https://huewrite.com/api/v1/humanizeThe endpoint accepts a JSON body and streams the humanized text back as text/plain. Available exclusively on the Max plan.
身份验证
Authenticate every request with your secret API key, sent as a Bearer token.
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.
请求正文
API接受JSON请求并返回流式文本响应。
| 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
{
"text": "Your AI-generated text here",
"tone": "standard",
"modelVersion": "v4beta",
"ultraMode": false,
"isRehumanization": false
}响应
On success the humanized text is streamed back chunk by chunk. Errors return a JSON object.
text/plain; charset=utf-8 — read the stream incrementally.error code and a human-readable message.{
"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.
代码示例
使用流行编程语言的代码示例快速入门。
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"
}'速率限制和使用
API请求受到与Web界面相同的速率限制和积分消耗：
Rate limit
30 / min
Requests per API key
Concurrency
2
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