Humanize textwith one request.
The engine behind Study Solutions, as a REST API. Prepaid and pay as you go — $0.05 per 1,000 words.
Pay as you go
Prepaid. No plan, no minimum spend.
Failures are free
Errors and timeouts refund themselves.
Streaming
Paragraphs arrive as they finish.
Multilingual
Replies in the language you send.
Never expires
Unused balance stays yours.
Traceable
A request ID on every call.
Start here
Quickstart
Create your key in the console above, export it as SS_API_KEY, and send text. The response is the humanized document plus what it cost.
curl https://www.studysolutions.app/api/v1/humanize \
-H "Authorization: Bearer $SS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Your AI-generated text goes here."}'Let your AI agent set it up
One click copies a setup prompt with this whole reference. Paste it into Claude Code, Cursor or Codex. View as Markdown
Keys
Authentication
Send your key as a Bearer token. x-api-key: ss_live_… also works.
Authorization: Bearer ss_live_…- Keys start with ss_live_ and are shown once.
- We store a SHA-256 hash, never the key.
- One key per account. Lost it? Regenerate it.
- Regenerating is instant: the old key fails on its next request.
Call the API from your server. A key in browser or app code can be copied by anyone who loads it.
Endpoint
Humanize
www.studysolutions.app/api/v1/humanizeRewrites AI-generated text so it reads as human-written. Formatting — headings, lists, blank lines — is kept. The reply comes back in the language you send.
Body
textstringrequiredmodelstring"studysolutions". Ryne AI is coming soon — until then "ryne" returns invalid_request.default "studysolutions"streambooleanuserstringstorebooleanResponse
idstringoutputstringusageobjectbalance_usdnumberstoredbooleanlatency_msnumber{
"id": "req_8f2c1e0b9d4a4c7f8e3b2a1d0c9e8f7a",
"object": "humanization",
"model": "studysolutions",
"output": "AI has reshaped how students learn…",
"usage": {
"input_words": 412,
"output_words": 405,
"cost_usd": 0.0206
},
"balance_usd": 9.9794,
"stored": true,
"latency_ms": 3840
}Try it
live · billed to your balance63 words · $0.00315
Sign in to run →Humanized text appears here.
Paragraphs stream in as each one finishes.
Optional
Streaming
With "stream": true the reply is application/x-ndjson — one JSON event per line, one paragraph event per paragraph of your document. Paragraphs are written in parallel, so they can arrive out of order; place each by its index. done carries the exact document.
index counts the non-blank lines of your text from 0: blank lines are skipped, and a ``` code block counts as one. A repeated index is a revision, so replace what you have; done or error is always the last event.
startRequest accepted and charged. Carries id and usage.progressHow many paragraphs the document has.paragraphOne finished paragraph: index + text. Lines kept as they are (headings) come first; a revised paragraph is re-sent with the same index.doneThe assembled output, usage, balance and latency.errorThe run failed. Nothing is charged. Ends the stream.{"type":"start","id":"req_8f2c…","model":"studysolutions","usage":{"input_words":412,"cost_usd":0.0206}}
{"type":"progress","paragraphs":3}
{"type":"paragraph","index":1,"text":"…"}
{"type":"paragraph","index":0,"text":"…"}
{"type":"paragraph","index":2,"text":"…"}
{"type":"done","id":"req_8f2c…","output":"…","usage":{…,"output_words":405},"balance_usd":9.9794,"stored":true,"latency_ms":3840}const res = await fetch("https://www.studysolutions.app/api/v1/humanize", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SS_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ text, stream: true }),
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
const paragraphs = [];
let buffer = "";
for (;;) {
const { done, value } = await reader.read();
if (done) break;
buffer += decoder.decode(value, { stream: true });
const lines = buffer.split("\n");
buffer = lines.pop();
for (const line of lines) {
if (!line) continue;
const event = JSON.parse(line);
if (event.type === "paragraph") paragraphs[event.index] = event.text;
if (event.type === "done") console.log(event.output, event.usage);
if (event.type === "error") throw new Error(event.error.message);
}
}Free
Word tools
The pieces of our own editor: which words are worth swapping, and replacements that fit the sentence. Any language — the answer comes back in the language you send. Free with your key.
www.studysolutions.app/api/v1/eligible-wordsBody
textstringrequiredOne entry per paragraph, numbered like the stream. Each word has start and end offsets into its paragraph (JavaScript string indices), so you can highlight it without splitting the text yourself.
{
"object": "eligible_words",
"paragraphs": [
{
"index": 0,
"words": [
{ "word": "Students", "start": 0, "end": 8 },
{ "word": "improve", "start": 13, "end": 20 },
{ "word": "learning", "start": 27, "end": 35 }
]
}
]
}curl https://www.studysolutions.app/api/v1/eligible-words \
-H "Authorization: Bearer $SS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Students can improve their learning when the school offers support."}'www.studysolutions.app/api/v1/synonymsBody
wordstringrequiredsentencestringUp to four alternatives, matched to the word's form. The list can be empty.
{
"object": "synonyms",
"word": "keeps",
"alternatives": ["stores", "holds", "preserves", "retains"]
}curl https://www.studysolutions.app/api/v1/synonyms \
-H "Authorization: Bearer $SS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"word": "keeps", "sentence": "The library keeps its rarest books in a cool room."}'Free
History & edits
Every successful humanization is kept, so you don't have to store it: fetch it by its id, list an end user's results, and save the edits your users make. Kept until you delete it. Send "store": false to keep nothing. We never use your text to train models.
www.studysolutions.app/api/v1/humanize/{id}output is the document as last saved; original_output is what the humanizer returned.
{
"id": "req_8f2c1e0b9d4a4c7f8e3b2a1d0c9e8f7a",
"object": "humanization",
"model": "studysolutions",
"user": "user_123",
"created_at": "2026-10-09T18:02:11.204Z",
"updated_at": "2026-10-09T18:09:40.517Z",
"input": "Artificial intelligence has fundamentally…",
"output": "AI has reshaped how students learn… (as last saved)",
"original_output": "AI has reshaped how students learn…",
"edits": 2,
"usage": { "input_words": 412, "output_words": 405, "cost_usd": 0.0206 }
}www.studysolutions.app/api/v1/humanize/{id}Body { "output": "..." }: saves your user's edited document as the next version and returns the result. The last 100 versions are kept; GET /humanize/{id}/edits lists them, newest first.
www.studysolutions.app/api/v1/humanizeResults newest first, with a short preview. Query: user (your end-user ID), limit (1–100, default 20), starting_after (the last id of the previous page).
www.studysolutions.app/api/v1/humanize/{id}Deletes the result and its edits.
# one result
curl https://www.studysolutions.app/api/v1/humanize/req_8f2c1e0b9d4a4c7f8e3b2a1d0c9e8f7a \
-H "Authorization: Bearer $SS_API_KEY"
# save your user's edited document
curl -X PATCH https://www.studysolutions.app/api/v1/humanize/req_8f2c1e0b9d4a4c7f8e3b2a1d0c9e8f7a \
-H "Authorization: Bearer $SS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"output": "The edited document…"}'
# one end user's history, newest first
curl "https://www.studysolutions.app/api/v1/humanize?user=user_123&limit=20" \
-H "Authorization: Bearer $SS_API_KEY"Endpoint
Balance
www.studysolutions.app/api/v1/balanceYour prepaid balance, and how many words it buys at the current rate.
It also shows your live capacity: limits is what may run at once on your account, usage what is running now — handy for showing capacity in your own app instead of waiting for a 429.
curl https://www.studysolutions.app/api/v1/balance \
-H "Authorization: Bearer $SS_API_KEY"{
"object": "balance",
"balance_usd": 9.9794,
"humanize_words_available": 199588,
"currency": "usd",
"limits": {
"max_running_requests": 3,
"max_active_checks": 3
},
"usage": {
"running_requests": 1,
"active_checks": 2
}
}Endpoint
Models
www.studysolutions.app/api/v1/modelsPublic, no key needed. Lists the models and the price.
studysolutionsdefaultStudy Solutions · $0.05 / 1K words
ryneComing soonRyne AI · not available over the API yet
curl https://www.studysolutions.app/api/v1/modelsReference
Errors
Every error has the same shape. Branch on error.type; messages can change.
{
"error": {
"type": "insufficient_balance",
"message": "Balance is too low for this request.",
"balance_usd": 0.0012,
"cost_usd": 0.0206
}
}| Status | Type | When |
|---|---|---|
| 400 | invalid_request | Body is not JSON, `text` is missing or empty, a field has the wrong type, or the model is not available yet. |
| 413 | text_too_long | Over 25,000 words (or 250,000 characters) in one request, or an edit over twice the size of its result. |
| 401 | invalid_api_key | Key missing, malformed, unknown or revoked. |
| 402 | insufficient_balance | Balance is below the cost of this request — or, on the free word tools and history, the account has never had balance. |
| 403 | account_disabled | The account is suspended or deleted. |
| 404 | not_found | No stored result with that ID on this account: it was deleted, sent with store: false, or the run failed. |
| 429 | concurrency_limit | 3 requests already in flight on this account. Retry when one finishes. |
| 429 | rate_limited | Over a free endpoint's limit (a minute: 1,000 eligible-words, 120 synonyms, 1,000 history calls), or the service is busy. Wait the Retry-After seconds. |
| 502 | engine_error | The engine failed mid-run. The charge is refunded. |
| 504 | timeout | The run took longer than 280 s. The charge is refunded. |
| 503 | service_unavailable | Temporary problem on our side. Safe to retry. |
Reference
Limits & billing
$0.05 / 1,000 words
Input words, charged when the request starts. Same rate as the app.
Never charged for failures
A run that errors or times out is refunded in full, automatically.
3 requests at a time
Per account. The next one gets 429 with Retry-After — retry when one finishes. GET /balance shows your limit and what is running.
25,000 words per request
Longer documents: split on paragraph breaks and send in parts.
Balance never expires
Top up $10–$500 at a time, by card or PayPal.
Timeouts
A run gets up to 280 s. Set your client timeout to 300 s.
Word tools and history are free
With any account that has added balance. A minute: 1,000 eligible-words, 120 synonyms and 1,000 history calls. Over that, or when the service is busy: 429 with Retry-After.
Response headers
X-Request-IdstringX-Concurrency-LimitnumberX-Concurrency-RemainingnumberRetry-AftersecondsBenchmarks
Coming soonPass rates for our engine against the leading humanizers on the major AI detectors — same documents, published with the method.