API Docs
Inksong for developers
REST API to humanize AI text from any application. Auth via API key. Three core endpoints. Full integration in under 50 lines.
Quickstart
Get an API key from your dashboard, then:
# Upload a document
curl -X POST https://api.inksong.app/api/v1/documents/upload \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@my-draft.docx" \
-F "tone=balanced" \
-F "humanness_level=50"
# → {"job_id":"abc123","status":"pending",...}
# Poll until complete
curl https://api.inksong.app/api/v1/documents/abc123 \
-H "X-API-Key: YOUR_API_KEY"
# → {"status":"completed","humanized_text":"...","original_ai_score":85,...}
# Download the formatted output
curl -L -o humanized.docx \
https://api.inksong.app/api/v1/documents/abc123/download \
-H "X-API-Key: YOUR_API_KEY"Full OpenAPI spec at https://api.inksong.app/openapi.json.
Reference
Authentication
API key + Bearer token flows. How to authenticate from server-to-server and short-lived integrations.
ReadDocuments
Upload, poll, and download — the core humanization flow. With curl, Python, and JavaScript examples.
ReadVoice profiles
Create, list, and delete voice profiles via the API. Apply a profile to a humanization run.
ReadWebhooks
Subscribe to job-completion events instead of polling. Design documented; delivery shipping in 2026-Q3.
ReadErrors
Error response shapes, status codes, and recovery patterns.
ReadRate limits
Per-endpoint limits, Retry-After header behaviour, and how to back off correctly.
ReadSDKs
Python and Node.js SDKs (planned, 2026-Q3). REST endpoints work today from any language.
ReadAPI changelog
Breaking changes, additions, deprecations — separate from the product changelog.
ReadNeed an API key?
Sign in and generate one from the dashboard.
- 5 documents/month on the free tier
- No credit card required
- Cancel or upgrade anytime