İçeriğe geç
TurnitPass
GeliştiricilerAPI v1
API anahtarı al
Belgelere göz at

GeliştiricilerAPI 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.

REST API v1

Referans konsolu

Rota, payload ve yanıt şekliyle başlayın.

Tam referans aşağıdaki tüm endpoint’leri kapsar. Konsol geliştiricilerin önce ihtiyaç duyduğu sözleşmeyi gösterir: Bearer auth, JSON girdi, ölçülen çıktı ve status kontrolleri.

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"
}
ölçülenkaydedilenJSON
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
İncelemePOST /detect
StatusGET /status
POST/api/v1/humanize
v1

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
v1

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
v1

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

POST/api/v1/detect
v1

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
v1

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
v1

İ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
v1

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

Parametreler ve seçenekler

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.

Hız limitleri ve istek limitleri

Dönüştürme girdisi
humanize/rewrite: 500; paraphrase: 2,000Quality units = CJK characters + other characters / 3, rounded up. Same limits on every plan.
Tespit girdisi
En fazla 5.000 kelimeDaha uzun detector taramaları gönderilmeden önce parçalanmalıdır.
API anahtarları
En fazla 5 etkin anahtarAnahtarlar çalışma alanından bağımsız olarak iptal edilebilir.
Atıf araçları
Ayrı hız limiticitation ve bibliography çağrıları kelime kredisi harcamaz.

Hata işleme

Hata yanıtları mümkün olduğunda error, code ve okunabilir message alanlarını içeren JSON kullanır.

error response
JSON
{
  "error": "Text exceeds word limit. Maximum 1,000 words allowed.",
  "code": "word_limit_exceeded",
  "max_words": 1000,
  "current_words": 1234
}
Stripe ve Google kimlik bilgileri yapılandırma olarak kalır. API yüzeyleri, auth akışı ve kalıcılık, canlı kimlik bilgilerinin ürünü yeniden tasarlamadan eklenebilmesi için uygulanmıştır.

Örnekler

Humanize örneği
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
}
Çoklu endpoint örneği
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..."
}

Sonraki adımlar

Hızlı Başlangıç

İlk isteği hazırlayın.

Doğrulama

API anahtarı yönetimini inceleyin.

Güncelleme Günlüğü

Son platform değişikliklerini görün.

Ardından iş akışınıza bağlayın.Okumaya devam et