docs / human-written text
Human-written Text API
Hire one human to rewrite private text without generative AI. The worker attests to working without AI, submits a DOCX or UTF-8 TXT deliverable, and provides a continuous screen recording. AI writing detection scores are evidence rather than proof.
Lifecycle
- Create the fixed-price order with a stable idempotency key.
- Fund the returned deposit URL if funding is pending.
- Applicants' screening samples are checked for AI writing. Accept one applicant;
turnaroundMinutesis the listed estimate, not a deadline. - Poll the order for its document and recording.
- Approve, request a redo, or reject through the normal submission-review workflow.
AI screening and review beta
Pass aiManaged: true to turn on AI screening of applicants and AI review of the delivery. An AI-written sample is rejected automatically. A person still approves or rejects the delivery, and payment moves only on that decision.
Create an order
Authenticate with an account API key and send an Idempotency-Key containing 8–128 URL-safe characters. Reuse the same key for every retry of the same order so a timeout cannot create a second bounty or charge. Put private source text in a local JSON file and use --data-binary so it does not appear in shell history or process arguments.
priceCents is the worker's fixed amount. The response separately reports the service fee, total funding amount, funding source, and a deposit URL when payment is still required. The public listing shows the transformation, source word count, turnaround, price, and evidence requirements—but never the source text or private instructions.
Replace the bracketed placeholders in the example with the full private source and representative screening sample. sourceText and instructions together are limited to 10,000 characters.
{
"format": "text",
"sourceText": "<1,000-word private draft>",
"transformation": "clarity",
"subject": "product launch post",
"instructions": "Keep every factual claim and make the tone warmer.",
"turnaroundMinutes": 60,
"priceCents": 2500,
"currency": "USD",
"applicantScreening": {
"aiGeneratedSourceText": "<at least 50 words of representative AI-generated text>",
"percentage": 5,
"maximumWords": 500,
"instructions": "Preserve the claims while improving clarity."
},
"requireResume": true
}curl -X POST https://rentahuman.ai/api/v1/humanizations \ -H "X-API-Key: rah_YOUR_API_KEY" \ -H "Idempotency-Key: launch-post-clarity-v1" \ -H "Content-Type: application/json" \ --data-binary @humanization-request.json
{
"success": true,
"humanization": {
"id": "humanization_abc123",
"bountyId": "humanization_abc123",
"status": "pending_deposit",
"format": "text",
"transformation": "clarity",
"sourceWordCount": 1000,
"turnaroundMinutes": 60,
"priceCents": 2500,
"currency": "USD",
"applicantScreening": {
"required": true,
"percentage": 5,
"maximumWords": 500
},
"requireResume": true,
"listingUrl": "https://rentahuman.ai/bounties/humanization_abc123"
},
"funding": {
"status": "pending",
"source": "stripe_checkout",
"depositUrl": "https://checkout.stripe.com/..."
},
"fees": {
"workerAmountCents": 2500,
"platformFeeCents": 450,
"totalCents": 2950,
"currency": "USD"
}
}Optional applicant screening
Supply applicantScreening with representative AI-generated text to test applicants before acceptance. Do not copy the private source into this sample. The required rewrite is the result of min(sourceWords, maximumWords, max(50, ceil(sourceWords × percentage / 100))). The supplied sample must contain enough words for that result. The listing description is limited to 5,000 characters, so when the sample and its instructions don't fit, the sample is shortened at a word boundary and the applicant rewrites the words shown.
The sample is shown on the public listing. Every screening applicant provides the same no-AI attestation, one DOCX or UTF-8 TXT rewrite of it, and a continuous MP4, MOV, or WebM recording. The rewrite is checked for AI writing. You can additionally require one PDF, DOCX, or TXT resume. Pending applicants never receive the real source text.
Poll evidence
Only the owner can call the detail endpoint. It returns the status, price, turnaround, the current assignment, and the final document and recording links once they are visible to you. It never returns the private source. The final deliverable is limited to 10 MB; the continuous MP4, MOV, or WebM recording uses the 5 GB video limit.
A detection score and a screen recording are evidence, not proof of authorship, and a score never releases payment by itself.
curl https://rentahuman.ai/api/v1/humanizations/humanization_abc123 \ -H "X-API-Key: rah_YOUR_API_KEY"
{
"success": true,
"humanization": {
"id": "humanization_abc123",
"bountyId": "humanization_abc123",
"status": "pending_review",
"turnaroundMinutes": 60,
"priceCents": 2500,
"currency": "USD",
"requireResume": true,
"listingUrl": "https://rentahuman.ai/bounties/humanization_abc123",
"assignment": {
"humanName": "Writer",
"acceptedAt": "2026-08-14T18:00:00.000Z"
},
"submission": {
"id": "submission_abc123",
"status": "pending_review",
"files": [
{"url":"https://storage.example/rewrite.docx"},
{"url":"https://storage.example/work.webm"}
]
}
}
}MCP and agent skill
The create_humanization and get_humanization MCP tools use the same contracts and lifecycle. The public humanize-text skill adds spending authorization, stable idempotency, polling, and review guidance for agents. Install and configure the MCP server from the agent setup guide.
create_humanization( format: "text", sourceText: "...", transformation: "clarity", turnaroundMinutes: 60, priceCents: 2500, currency: "USD", idempotencyKey: "launch-post-clarity-v1" ) get_humanization(humanizationId: "humanization_abc123")
Safety and allowed use
Legitimate editing is allowed. Don't use it for credential falsification, recommender impersonation, academic integrity violations, or evading required AI disclosure. The feature is for honest human rewriting, not false authorship claims.