🔌 REST API

API Documentation

Integrate AI text humanization into your workflow. Available on Unlimited plans.

🔑 API Access

API access is included in the Unlimited plan (100K words/month via API). Authenticate using your session cookie or contact us for a dedicated API key.

View Pricing →

Humanize Text

POSThttps://ai-to-human.com/api/humanize

Request Body

{
  "text": "string",           // Required. AI-generated text to humanize (max 10K words for Unlimited)
  "mode": "blog",             // Optional. One of: blog, casual, academic, professional, standard
  "intensity": "medium",      // Optional. One of: light, medium, heavy
  "terms": ["term1", ...],    // Optional. Up to 20 terms to preserve (Term Shield)
  "include_detection": false  // Optional. Include AI detection scores (Pro+)
}

Parameter	Type	Required	Description
`text`	string	Yes	The AI-generated text to humanize
`mode`	string	No	Writing mode. Default: blog. Options: blog, casual, academic, professional, standard
`intensity`	string	No	Rewrite intensity. Default: medium. Options: light, medium, heavy
`terms`	array	No	Array of terms to preserve unchanged (Term Shield). Max 20 terms
`include_detection`	boolean	No	Return AI detection scores before/after. Default: false

Response

{
  "humanized_text": "string",   // The rewritten, humanized text
  "original_text": "string",    // Original input text
  "changes": [...],             // Array of modifications with reasons
  "plan": "unlimited",          // Your current plan
  "words_processed": 342,       // Word count processed
  "watermark": ""               // Empty for Pro/Unlimited plans
}

Example Request

curl -X POST https://ai-to-human.com/api/humanize \
  -H "Content-Type: application/json" \
  -H "Cookie: YOUR_SESSION_COOKIE" \
  -d '{
    "text": "The implementation of machine learning algorithms...",
    "mode": "academic",
    "intensity": "medium",
    "terms": ["machine learning", "neural network"]
  }'

* Session-based auth only. Dedicated API keys coming soon.

Error Codes

HTTP	Error Code	Description
400	`TEXT_TOO_LONG`	Text exceeds word limit for your plan
400	`TEXT_TOO_SHORT`	Text is too short (minimum 10 words)
403	`MODE_NOT_ALLOWED`	Mode not available on your plan
429	`RATE_LIMIT_EXCEEDED`	Too many requests. Check Retry-After header
429	`DAILY_LIMIT_REACHED`	Daily word limit reached (Free plan)
429	`MONTHLY_LIMIT_REACHED`	Monthly word limit reached (Pro plan)
401	`UNAUTHORIZED`	Authentication required

Rate Limits

Plan	Per Request	Monthly	API Access
Guest	500 words	1,000 words/day	✗
Free	5,000 words	5,000 words/day	✗
Pro	5,000 words	100,000 words	✗
Unlimited	10,000 words	Unlimited	✓ 100K words/month

Ready to integrate?

Get API access with the Unlimited plan

View Pricing