Documentation

Everything you need to use turnmytext: the website, the API, and managing your account.

Getting Started
Writing Modes
Intensity Levels
File Upload
Plans & Limits
API Reference
API Key Management
Rate Limits
Error Codes
Support

Getting Started

turnmytext converts AI-generated text into natural, human-sounding writing. You can use it in two ways:

1. Website: Paste text, choose a mode and intensity, click Humanize.

2. API: Send text programmatically and get back humanized text. Available on Pro and Unlimited plans.

Quick Start (Website)

Go to turnmytext.com
Paste your AI-generated text in the left box
Choose a writing mode (General, Academic, Email, Casual)
Choose intensity (Light, Medium, Strong)
Click Humanize
Copy the result from the right box

Free users get 500 words per day. No account required.

Writing Modes

Mode	Best For	Style
`general`	Blog posts, articles, general writing	Natural conversational tone, contractions, varied sentences
`academic`	Research papers, essays, assignments	Formal but authentic. Keeps technical terms, no slang or casual fillers
`email`	Professional emails, business writing	Warm but efficient. Direct sentences, first person
`casual`	Social media, personal writing	Very relaxed. Sentence fragments OK, filler words, informal punctuation

Intensity Levels

Intensity	Changes	Length Deviation
`light`	Minimal. Fixes AI patterns only, preserves your voice	Within 5%
`medium`	Balanced. Rewrites most sentences with natural flow	Within 10-15%
`strong`	Heavy. Substantially different phrasing throughout	Up to 20%

File Upload

Upload entire documents and get them back humanized. Available on paid plans only.

Format	Max Size	Output
DOCX	10 MB	DOCX
PDF	10 MB	DOCX (text extracted and humanized)
TXT	10 MB	TXT

Upload via the website interface. You can drag and drop or click to browse. Processed files are available for download for 60 seconds, then automatically deleted.

Plans & Limits

Plan	Price	Words	File Upload	API
Free	$0	500/day	No	No
Starter	$8/mo	10,000/month	Yes	No
Pro	$16/mo	50,000/month	Yes	Yes
Unlimited	$29/mo	Unlimited	Yes	Yes

Annual plans get 50% off. Word limits reset on the 1st of each month (paid plans) or daily at midnight UTC (free plan).

API Reference

The API lets you humanize text programmatically. Available on Pro and Unlimited plans.

Base URL: https://turnmytext.com/api/v1
Auth: Pass your API key as a Bearer token: Authorization: Bearer tmt_your_key

POST /api/v1/humanize

Humanize a piece of text.

Request Body

Field	Type	Required	Description
`text`	string	Yes	The text to humanize (min 10 chars)
`mode`	string	No	`general`, `academic`, `email`, `casual`. Default: `general`
`intensity`	string	No	`light`, `medium`, `strong`. Default: `medium`

Example Request

# cURL
curl -X POST https://turnmytext.com/api/v1/humanize \
  -H "Authorization: Bearer tmt_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "It is essential to utilize comprehensive strategies.",
    "mode": "general",
    "intensity": "medium"
  }'

# Python
import requests

response = requests.post(
    "https://turnmytext.com/api/v1/humanize",
    headers={"Authorization": "Bearer tmt_your_api_key"},
    json={
        "text": "It is essential to utilize comprehensive strategies.",
        "mode": "general",
        "intensity": "medium"
    }
)
print(response.json()["result"])

// JavaScript / Node.js
const res = await fetch("https://turnmytext.com/api/v1/humanize", {
    method: "POST",
    headers: {
        "Authorization": "Bearer tmt_your_api_key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        text: "It is essential to utilize comprehensive strategies.",
        mode: "general",
        intensity: "medium"
    })
});
const data = await res.json();
console.log(data.result);

Response

200 Success

{
  "success": true,
  "result": "You really need to use solid, well-thought-out strategies.",
  "meta": {
    "words_in": 8,
    "words_out": 9,
    "mode": "general",
    "intensity": "medium",
    "model": "gpt-4o-mini"
  }
}

GET /api/v1/usage

Check your current usage and remaining quota.

Example Response

{
  "plan": "pro",
  "usage": 12450,
  "limit": 50000,
  "period": "month",
  "remaining": 37550
}

API Key Management

Manage your API keys through the website or the API itself. You can have up to 5 active keys.

POST /api/keys

Create a new API key. Requires session auth (must be logged in on the website).

Field	Type	Description
`name`	string	Optional label for the key (e.g. "My App")

Important: The full API key is only shown once when created. Save it immediately. You won't be able to see it again.

GET /api/keys

List all your API keys (masked). Requires session auth.

DELETE /api/keys/:keyPrefix

Delete an API key. Requires session auth.

Rate Limits

Plan	Requests/min	Requests/hour	Max words/request
Free	5	30	2,000
Starter	10	100	2,000
Pro	15	300	5,000
Unlimited	20	500	10,000

API-specific limits	Value
Requests/min per key	15
Requests/hour per key	200

When rate limited, you'll receive a 429 response. Wait and retry.

Error Codes

Status	Meaning
400	Bad request. Text too short, invalid format, or missing fields
401	Unauthorized. Missing or invalid API key
403	Forbidden. Your plan does not include this feature
429	Rate limited or word limit reached
500	Server error. Try again. If persistent, contact support

All error responses follow this format:

{
  "error": "Description of what went wrong"
}

Support

Need help? Reach us at:

Email: [email protected]

We typically respond within 24 hours.

Common Issues

Issue	Solution
Output sounds too casual for academic work	Use `academic` mode with `light` intensity
Output is too similar to input	Increase intensity to `strong`
Hit word limit too fast	Upgrade your plan at turnmytext.com/#pricing
API key not working	Ensure you're on Pro or Unlimited plan. Keys from downgraded accounts are blocked.
File upload not showing	File upload requires a paid plan (Starter or above)