NewUnCopy now works inside Claude, ChatGPT and Cursor→
REST · JSON · API keys

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 →
$12.50per million words
3,000words per request
3endpoints
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"
}
Quickstart

Up and running in three steps

01

Turn on API billing

Add a card in Account → Billing. You pay $12.50 per million words, billed monthly for what you use.

02

Create a key

Go to Account → API keys. The secret is shown once, so store it safely.

03

Send a request

POST your text to /api/v1/humanize and read humanized_text.

Authentication

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.

Keep keys on the server

Never put a secret key in browser or mobile app code. Call UnCopy from your backend.

POST/api/v1/humanize

Humanize text

Rewrites the text and charges its word count to your balance. If the rewrite fails, the words are refunded automatically.

Request body

FieldTypeDescription
text requiredstringThe text to rewrite. 1 to 3,000 words.
modestringbalanced (default), deep or fast.
typestringgeneral (default), academic, blog or news.
voicestringOptional. 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

FieldTypeDescription
humanized_textstringThe rewritten text.
words_processednumberWords charged for this request.
words_remainingnumberYour balance after this request.
mode, type, voicestringThe settings that were used.
GET/api/v1/voices

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 }
  ]
}
GET/api/v1/usage

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

Errors are plain JSON

Every error has the same shape: { "error": "code", "message": "Readable explanation" }.

StatusCodeWhen
400invalid_inputBody isn't JSON, text is empty, or a field has an unknown value.
401unauthorizedThe key is missing, wrong or revoked.
403forbiddenAPI billing isn't turned on for this account.
403quota_exceededYou hit the monthly spending limit you set. Raise it in Account → Billing.
404voice_not_foundThe voice id doesn't exist or isn't shared with you.
413too_longMore than 3,000 words in one request. Split the text.
502api_errorThe rewrite failed. You weren't charged, so retry.
Pricing

$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:

Words per month2M
Monthly cost$25 ₹2,125
Get an API key →