Developer APIv1

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.

No subscriptionFailed runs refundedBalance never expires
POST /v1/humanize
Live
$ curl www.studysolutions.app/api/v1/humanize \ -H "Authorization: Bearer $SS_API_KEY" \ -d '{"text": "AI has transformed…", "stream": true}'
{"type":"start","usage":{"input_words":412,"cost_usd":0.0206}}
{"type":"paragraph","index":1,"text":"Teachers spot gaps sooner…"}
{"type":"paragraph","index":0,"text":"AI has reshaped how we learn…"}
{"type":"paragraph","index":2,"text":"Students show up ready…"}
{"type":"done","latency_ms":3840,"balance_usd":9.9794}
Paragraphs
3/3
  • 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.

Header
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

POSTwww.studysolutions.app/api/v1/humanize

Rewrites 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

textstringrequired
The text to humanize. Up to 25,000 words.
modelstring
"studysolutions". Ryne AI is coming soon — until then "ryne" returns invalid_request.default "studysolutions"
streamboolean
Stream NDJSON events as paragraphs finish. See Streaming.default false
userstring
Your own ID for the end user, up to 128 characters. Lets you list one user's history.
storeboolean
Keep the result for history. false keeps nothing.default true

Response

idstring
Request ID. Also in the X-Request-Id header — quote it to support.
outputstring
The humanized document.
usageobject
input_words, output_words, cost_usd.
balance_usdnumber
Balance left after this request.
storedboolean
Whether the result was kept for history.
latency_msnumber
Time on our side, end to end.
200 OK
{
  "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 balance

63 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.
Event 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.

POSTwww.studysolutions.app/api/v1/eligible-words

Body

textstringrequired
A paragraph or a whole document — typically a humanize output. Up to 250,000 characters.

One 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.

200 OK
{
  "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."}'
POSTwww.studysolutions.app/api/v1/synonyms

Body

wordstringrequired
One word, as it appears in the text.
sentencestring
The sentence the word is in. Alternatives then match its meaning and grammar; without it they are context-free.

Up to four alternatives, matched to the word's form. The list can be empty.

200 OK
{
  "object": "synonyms",
  "word": "keeps",
  "alternatives": ["stores", "holds", "preserves", "retains"]
}
cURL
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.

GETwww.studysolutions.app/api/v1/humanize/{id}

output is the document as last saved; original_output is what the humanizer returned.

200 OK
{
  "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 }
}
PATCHwww.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.

GETwww.studysolutions.app/api/v1/humanize

Results 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).

DELETEwww.studysolutions.app/api/v1/humanize/{id}

Deletes the result and its edits.

cURL
# 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

GETwww.studysolutions.app/api/v1/balance

Your 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
curl https://www.studysolutions.app/api/v1/balance \
  -H "Authorization: Bearer $SS_API_KEY"
200 OK
{
  "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

GETwww.studysolutions.app/api/v1/models

Public, no key needed. Lists the models and the price.

studysolutionsdefault

Study Solutions · $0.05 / 1K words

ryneComing soon

Ryne AI · not available over the API yet

cURL
curl https://www.studysolutions.app/api/v1/models

Reference

Errors

Every error has the same shape. Branch on error.type; messages can change.

402 Payment Required
{
  "error": {
    "type": "insufficient_balance",
    "message": "Balance is too low for this request.",
    "balance_usd": 0.0012,
    "cost_usd": 0.0206
  }
}
StatusTypeWhen
400invalid_requestBody is not JSON, `text` is missing or empty, a field has the wrong type, or the model is not available yet.
413text_too_longOver 25,000 words (or 250,000 characters) in one request, or an edit over twice the size of its result.
401invalid_api_keyKey missing, malformed, unknown or revoked.
402insufficient_balanceBalance is below the cost of this request — or, on the free word tools and history, the account has never had balance.
403account_disabledThe account is suspended or deleted.
404not_foundNo stored result with that ID on this account: it was deleted, sent with store: false, or the run failed.
429concurrency_limit3 requests already in flight on this account. Retry when one finishes.
429rate_limitedOver 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.
502engine_errorThe engine failed mid-run. The charge is refunded.
504timeoutThe run took longer than 280 s. The charge is refunded.
503service_unavailableTemporary 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-Idstring
Same as the body id.
X-Concurrency-Limitnumber
Requests allowed in flight (3).
X-Concurrency-Remainingnumber
Free slots when this request started.
Retry-Afterseconds
On 429 only.

Benchmarks

Coming soon

Pass rates for our engine against the leading humanizers on the major AI detectors — same documents, published with the method.