Quickstart

This guide will get you up and running with the ToHuman API in under 5 minutes. You'll learn how to get your API key and make your first humanization request.

Get your API key

Before making your first API call, you need an API token. Sign in to your ToHuman dashboard and create a new API token. Your token will start with token_ and should be kept secret.

Environment variable

export TOHUMAN_API_KEY="token_your_api_key_here"

Make your first request

The simplest way to use ToHuman is the synchronous endpoint. Send your AI-generated text and get the humanized result back immediately.

POST /api/v1/humanizations/sync

curl -X POST https://tohuman.ai/api/v1/humanizations/sync \
  -H "Authorization: Bearer $TOHUMAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Your AI-generated content here...",
    "intensity": "medium"
  }'

Response

{
  "id": "hum_abc123",
  "status": "completed",
  "intensity": "medium",
  "output_content": "Your humanized content here...",
  "processing_time": 1.42,
  "created_at": "2026-03-21T12:00:00Z",
  "completed_at": "2026-03-21T12:00:01Z"
}

Here's the same request in Python:

Python

import requests

response = requests.post(
    "https://tohuman.ai/api/v1/humanizations/sync",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "content": "Your AI-generated content here...",
        "intensity": "medium"
    }
)

print(response.json())

Sync vs async

ToHuman offers two modes for humanizing text:

	Sync	Async
Endpoint	/humanizations/sync	/humanizations
Max length	2,000 words	Unlimited
Response	Immediate result	Returns job ID, poll or use webhook
Webhook	Not supported	Optional `webhook_url`
Best for	Short content, real-time UIs	Long documents, batch processing

Next steps

Now that you've made your first request, explore the full API: