Humanize text from your own app.
One endpoint, one header, plain JSON. The same engine as the website, priced at $12.50 per million words.
AgentsBuilding an agent? Use the MCP server instead of raw API calls →curl -X POST https://uncopy.ai/api/v1/humanize \ -H "X-API-Key: sk_live_••••••••" \ -H "Content-Type: application/json" \ -d '{ "text": "Artificial intelligence has become increasingly prevalent…", "mode": "balanced", "type": "blog", "voice": "vp_8Kd2" }' # 200 OK { "humanized_text": "AI is everywhere now, and it helps…", "words_processed": 23, "words_remaining": 1999977, "mode": "balanced", "type": "blog", "voice": "vp_8Kd2" }
const res = await fetch("https://uncopy.ai/api/v1/humanize", { method: "POST", headers: { "X-API-Key": process.env.UNCOPY_API_KEY, "Content-Type": "application/json", }, body: JSON.stringify({ text: draft, mode: "balanced", // balanced | deep | fast type: "blog", // general | academic | blog | news voice: "vp_8Kd2", // optional voice profile id }), }); if (!res.ok) { const { error, message } = await res.json(); throw new Error(`${error}: ${message}`); } const { humanized_text } = await res.json();
import os, requests res = requests.post( "https://uncopy.ai/api/v1/humanize", headers={"X-API-Key": os.environ["UNCOPY_API_KEY"]}, json={ "text": draft, "mode": "deep", "type": "news", "voice": "vp_8Kd2", # optional }, timeout=60, ) res.raise_for_status() print(res.json()["humanized_text"])
Up and running in three steps
Turn on API billing
Add a card in Account → Billing. You pay $12.50 per million words, billed monthly for what you use.
Create a key
Go to Account → API keys. The secret is shown once, so store it safely.
Send a request
POST your text to /api/v1/humanize and read humanized_text.
Send your key in a header
Every request needs a secret key that starts with sk_live_. Send it as X-API-Key, or as Authorization: Bearer. Keys belong to your account and draw from its word balance. Revoke a key at any time from your account page.
Never put a secret key in browser or mobile app code. Call UnCopy from your backend.
Humanize text
Rewrites the text and charges its word count to your balance. If the rewrite fails, the words are refunded automatically.
Request body
| Field | Type | Description |
|---|---|---|
text required | string | The text to rewrite. 1 to 3,000 words. |
mode | string | balanced (default), deep or fast. |
type | string | general (default), academic, blog or news. |
voice | string | Optional. A voice profile id such as vp_8Kd2. The rewrite matches that voice. Leave it out for the natural default. List ids with GET /api/v1/voices. |
Response
| Field | Type | Description |
|---|---|---|
humanized_text | string | The rewritten text. |
words_processed | number | Words charged for this request. |
words_remaining | number | Your balance after this request. |
mode, type, voice | string | The settings that were used. |
List voice profiles
Returns the voice profiles your account can use, including voices shared by your team. Create and edit voices in the web app. Free to call.
{
"voices": [
{ "id": "vp_8Kd2", "name": "My voice", "shared": false },
{ "id": "vp_3Lm9", "name": "Acme brand", "shared": true }
]
}Check your balance
Returns your plan, the words you have left and the words you've used in total. It doesn't cost anything to call.
{
"plan": "api",
"words_remaining": 1999977,
"words_used": 23
}Errors are plain JSON
Every error has the same shape: { "error": "code", "message": "Readable explanation" }.
| Status | Code | When |
|---|---|---|
| 400 | invalid_input | Body isn't JSON, text is empty, or a field has an unknown value. |
| 401 | unauthorized | The key is missing, wrong or revoked. |
| 403 | forbidden | API billing isn't turned on for this account. |
| 403 | quota_exceeded | You hit the monthly spending limit you set. Raise it in Account → Billing. |
| 404 | voice_not_found | The voice id doesn't exist or isn't shared with you. |
| 413 | too_long | More than 3,000 words in one request. Split the text. |
| 502 | api_error | The rewrite failed. You weren't charged, so retry. |
$12.50 per million words
Pay as you go, billed monthly for the words you use. No minimum, and you can set a spending limit. Estimate your bill: