Docs menuएपीआई संदर्भ

API ReferenceTyped request and response

एपीआई संदर्भ

TurnitPass REST एपीआई

प्रमाणित लेखन सुधार, पैराफ़्रेज़, AI जाँच, उद्धरण, संदर्भ सूची और API कुंजी स्थिति एंडपॉइंट का संदर्भ दस्तावेज़।

Reference console

Start with the route, payload, and response shape.

The full reference covers every endpoint below. The console shows the contract developers need first: Bearer auth, JSON input, metered output, and status checks.

request

POST

fetch('/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    text: 'Paste the draft here',
    language: 'en',
    mode: 'reduce-aigc'
  })
})

response

200 OK

{
  "output": "The revised text...",
  "words_used": 142,
  "words_remaining": 2858,
  "status": "succeeded"
}

meteredloggedJSON

POST/api/v1/humanize

POST/api/v1/paraphrase

POST/api/v1/rewrite

POST/api/v1/detect

POST/api/v1/citation

AuthBearer API key

TransformPOST /humanize

ReviewPOST /detect

StatusGET /status

POST/api/v1/humanize

भेजे गए पाठ में AI-जैसे लेखन संकेत कम करता है। मोड: reduce-aigc, reduce-both, paraphrase, academic-polish।

POST/api/v1/paraphrase

पाठ को मानक, प्रवाह, औपचारिक, शैक्षणिक, सरल, रचनात्मक, विस्तार या संक्षिप्त मोड से फिर से लिखता है।

POST/api/v1/rewrite

स्पष्ट वाक्य संरचना, लहजा और संदर्भ प्रवाह के लिए शैक्षणिक संपादन फ़ंक्शन।

POST/api/v1/detect

चिपकाए गए पाठ या दस्तावेज़ों से निकाले गए पाठ के लिए AI-जैसे लेखन संकेत अनुमान, मेटाडेटा और समीक्षा नोट देता है।

POST/api/v1/citation

DOI, URL, या मैन्युअल संदर्भों को APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA, या Bluebook प्रारूप में व्यवस्थित करता है। प्रतिक्रियाओं में HTML, सादा पाठ, BibTeX और RIS शामिल हैं।

POST/api/v1/bibliography

अनुरोधित शैली में संदर्भों की सूची को क्रमबद्ध और व्यवस्थित करता है; HTML/पाठ आउटपुट के साथ BibTeX और RIS फ़ाइल निर्यात का समर्थन करता है।

GET/api/v1/status

कुंजी लेबल, शेष शब्द और अनुरोध सीमा की जाँच करें।

Parameters and options

प्रमाणीकरण

Authorization: Bearer tp_your_api_key

विशेष शब्द सुरक्षित रखें

वैकल्पिक personal_terms सूची अंग्रेज़ी पाठ सुधार के दौरान नाम, तकनीकी शब्द और ब्रांड नाम सुरक्षित रखती है।

सीमाएं

रूपांतरण एंडपॉइंट्स अधिकतम 1,000 इनपुट शब्द स्वीकार करते हैं। AI जाँच अधिकतम 5,000 शब्द स्वीकार करती है। उद्धरण API दर-सीमित है लेकिन आपके शब्दों की सीमा को कम नहीं करता।

त्रुटियां

JSON प्रतिक्रियाओं में error, code और message फ़ील्ड शामिल होते हैं।

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "Paste the AI-assisted draft you want to revise",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["विशेष नाम"]
}

200 OK
{
  "output": "सुधरा हुआ परिणाम...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "जिस मसौदे को फिर से लिखना है उसे चिपकाएँ",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Paste the text you want to check",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "फ़ॉर्मैट किया हुआ उद्धरण...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Next steps

त्वरित शुरुआत

Set up the first request.

प्रमाणीकरण

Review API key handling.

बदलाव लॉग

See recent platform changes.

fetch('/api/v1/humanize', { method: 'POST', headers: { Authorization: 'Bearer tp_live_your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ text: 'Paste the draft here', language: 'en', mode: 'reduce-aigc' }) })

Parameters and options

प्रमाणीकरण

Authorization: Bearer tp_your_api_key

विशेष शब्द सुरक्षित रखें

सीमाएं

त्रुटियां

JSON प्रतिक्रियाओं में error, code और message फ़ील्ड शामिल होते हैं।

Rate limits and request limits

Transform input

Up to 1,000 wordsApplies to humanize, paraphrase, and rewrite endpoints.

Detection input

Up to 5,000 wordsLonger detector scans should be chunked before submission.

API keys

Up to 5 active keysKeys can be revoked independently from the workspace.

Citation tools

Rate-limited separatelyCitation and bibliography calls do not spend word credits.

Error handling

Error responses use JSON with error,code, and human-readable message fields where possible.

error response

JSON

{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}

The Stripe and Google credentials are configuration points. The API surfaces, auth flow, and persistence are implemented so live credentials can be added without redesigning the product.

Examples

Humanize example

JSON

POST /api/v1/humanize
{
  "text": "Paste the AI-assisted draft you want to revise",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["विशेष नाम"]
}

200 OK
{
  "output": "सुधरा हुआ परिणाम...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "जिस मसौदे को फिर से लिखना है उसे चिपकाएँ",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Paste the text you want to check",
  "language": "en",
  "source_kind": "paste"
}

POST /api/v1/citation
{
  "input": "https://example.com/article",
  "style": "apa"
}

200 OK
{
  "text": "फ़ॉर्मैट किया हुआ उद्धरण...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}