Docs menuAPI Referansı

API ReferenceTyped request and response

API Referansı

TurnitPass REST API

Kimliği doğrulanmış yazım düzenleme, yeniden ifade, AI tespiti, atıf, kaynakça ve API anahtar durumu işlevleri için referans.

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

Gönderilen metni düzenler ve AI benzeri yazım sinyallerini azaltır. Modlar: reduce-aigc, reduce-both, paraphrase, academic-polish.

POST/api/v1/paraphrase

Standart, akıcılık, resmi, akademik, basit, yaratıcı, genişletme veya kısaltma modlarıyla metni yeniden yazar ve düzenler.

POST/api/v1/rewrite

Daha temiz yapı, ton ve cümle akışı için akademik düzenleme işlevi.

POST/api/v1/detect

Yapıştırılan metin veya çıkarılan belgeler için AI benzeri yazım sinyali tahminleri, meta veriler ve revizyon notları döner.

POST/api/v1/citation

DOI, URL veya manuel atıfları APA, MLA, Chicago, IEEE, Harvard, Nature, Vancouver, ACS, AMA, GB/T, OSCOLA veya Bluebook formatında biçimlendirir. Yanıtlar html, metin, BibTeX ve RIS içerir.

POST/api/v1/bibliography

İstenen stilde bir atıf listesini sıralar ve biçimlendirir; html/metin çıktısı ile BibTeX ve RIS dışa aktarımları sağlar.

GET/api/v1/status

Anahtar etiketini, kalan kelime bakiyesini ve istek limitlerini kontrol edin.

Parameters and options

Yetkilendirme

Authorization: Bearer tp_your_api_key

Korunacak terimler

İsteğe bağlı personal_terms dizisi, İngilizce düzenleme sırasında özel adları, teknik terimleri ve marka yazımlarını korur.

Limitler

Düzenleme işlevleri en fazla 1.000 girdi kelimesi kabul eder. Tespit en fazla 5.000 kelime kabul eder. Atıf işlevleri ayrı limitlere sahiptir ve kelime kredisini tüketmez.

Hatalar

JSON yanıtları error, code ve message alanlarını içerir.

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": "Düzenlemek istediğiniz AI destekli taslağı yapıştırın",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["Özel ad"]
}

200 OK
{
  "output": "Düzenlenmiş metin...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Yeniden yazılmasını istediğiniz taslağı yapıştırın",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Kontrol etmek istediğiniz taslağı yapıştırın",
  "language": "en",
  "source_kind": "paste"
}

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

200 OK
{
  "text": "Biçimlendirilmiş atıf...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}

Next steps

Hızlı Başlangıç

Set up the first request.

Doğrulama

Review API key handling.

Güncelleme Günlüğü

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

Yetkilendirme

Authorization: Bearer tp_your_api_key

Korunacak terimler

İsteğe bağlı personal_terms dizisi, İngilizce düzenleme sırasında özel adları, teknik terimleri ve marka yazımlarını korur.

Limitler

Düzenleme işlevleri en fazla 1.000 girdi kelimesi kabul eder. Tespit en fazla 5.000 kelime kabul eder. Atıf işlevleri ayrı limitlere sahiptir ve kelime kredisini tüketmez.

Hatalar

JSON yanıtları error, code ve message alanlarını içerir.

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": "Düzenlemek istediğiniz AI destekli taslağı yapıştırın",
  "language": "en",
  "mode": "reduce-aigc",
  "personal_terms": ["Özel ad"]
}

200 OK
{
  "output": "Düzenlenmiş metin...",
  "words_used": 142,
  "words_remaining": 2858
}

Multi-endpoint example

JSON

POST /api/v1/paraphrase
{
  "text": "Yeniden yazılmasını istediğiniz taslağı yapıştırın",
  "mode": "academic",
  "synonyms_level": 60
}

POST /api/v1/detect
{
  "text": "Kontrol etmek istediğiniz taslağı yapıştırın",
  "language": "en",
  "source_kind": "paste"
}

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

200 OK
{
  "text": "Biçimlendirilmiş atıf...",
  "bibtex": "@article{...}",
  "ris": "TY  - JOUR..."
}