API Dokümantasyonu

AI Dedektör API

AI Dedektör API, yapay zeka tarafından üretilmiş metinleri tespit etmek için geliştirilmiş güçlü bir RESTful API'dir. Tek bir HTTP isteği ile metinlerin AI tarafından yazılıp yazılmadığını yüksek doğrulukla analiz edebilirsiniz.

Hızlı Yanıt

Ortalama 200ms yanıt süresi ile anlık sonuçlar alın.

Güvenilir

RoBERTa tabanlı MPU modeli ile yüksek doğruluk oranı.

Kolay Entegrasyon

Tek endpoint, basit JSON formatı. Dakikalar içinde entegre edin.

Base URLhttps://aidedektor.com

Kimlik Doğrulama

API'ye yapılan tüm isteklerde X-API-Key header'ı ile geçerli bir API anahtarı göndermeniz gerekmektedir. API anahtarlarınızı anahtar yönetim panelinden oluşturabilirsiniz.

Header Örneğihttp

GET /api/v1/detect HTTP/1.1
Host: aidedektor.com
Content-Type: application/json
X-API-Key: aidet_sk_a1b2c3d4e5f6...

Güvenlik Uyarısı

API anahtarınızı asla istemci tarafında (frontend, mobil uygulama) açık şekilde kullanmayın. Anahtarınızı her zaman sunucu tarafında tutun.

Anahtar Formatı

API anahtarları aidet_ öneki ile başlar ve 43 karakter uzunluğundadır.

Hızlı Başlangıç

3 adımda API'yi kullanmaya başlayın:

API Anahtarı Alın

Pro veya Kurumsal pakete sahip olun ve anahtar yönetim panelinden yeni bir API anahtarı oluşturun.

İlk İsteği Gönderin

curl -X POST https://aidedektor.com/api/v1/detect \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"text": "Bu metin yapay zeka tarafindan yazilmistir."}'

Sonucu Değerlendirin

{
  "ai_probability": 87.3,
  "human_probability": 12.7,
  "verdict": "ai",
  "word_count": 7,
  "remaining_credits": 499
}

verdict alanı "ai", "mixed" veya "human" değerlerinden birini döndürür.

Metin Analizi

Bir metni yapay zeka tarafından yazılıp yazılmadığını analiz etmek için kullanın.

POST/api/v1/detect

İstek Formatı

Headers

Parametre	Tip	Açıklama
`Content-Type`*	string	application/json olmalıdır
`X-API-Key`*	string	API anahtarınız

Body Parametreleri

Parametre	Tip	Açıklama
`text`*	string	Analiz edilecek metin. Minimum 20 karakter olmalıdır.

Örnek İstekjson

{
  "text": "Yapay zeka son yillarda buyuk gelismeler kaydetti..."
}

Yanıt Formatı

Başarılı Yanıt (200 OK)

Parametre	Tip	Açıklama
`ai_probability`	float	AI tarafından yazılma olasılığı (0-100)
`human_probability`	float	İnsan tarafından yazılma olasılığı (0-100)
`verdict`	string	"ai", "mixed" veya "human"
`word_count`	integer	Analiz edilen metnin kelime sayısı
`remaining_credits`	integer	Hesabınızda kalan kredi

Karar Eşik Değerleri

Verdict	AI Olasılığı	Anlamı
`ai`	>= 70%	Büyük olasılıkla AI tarafından üretilmiş
`mixed`	30% - 70%	Karışık içerik veya belirsiz
`human`	< 30%	Büyük olasılıkla insan tarafından yazılmış

Örnek Yanıtjson

{
  "ai_probability": 87.3,
  "human_probability": 12.7,
  "verdict": "ai",
  "word_count": 42,
  "remaining_credits": 499
}

Kod Örnekleri

Aşağıda farklı programlama dilleri için örnekler bulabilirsiniz.

curl -X POST https://aidedektor.com/api/v1/detect \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"text": "Analiz edilecek metin buraya yazilir."}'

Hata Kodları

API, standart HTTP durum kodlarını kullanır.

Kod	Tür	Açıklama
`200`	OK	İstek başarılı
`400`	Bad Request	Metin 20 karakterden kısa
`401`	Unauthorized	Geçersiz API anahtarı
`403`	Forbidden	Krediniz bitti
`429`	Rate Limited	Çok fazla istek
`500`	Server Error	Sunucu hatası

Limitler & Kotalar

API kullanımı planınıza göre sınırlandırılmıştır.

Özellik	Pro	Kurumsal
Aylık Kredi	500	5.000
Kelime / İstek	10.000	Sınırsız
API Anahtar	5	5
İstek / Dakika	60	300
Destek	Öncelikli	7/24 Özel

Kredi Tüketimi

Her başarılı analiz 1 kredi tüketir. Başarısız istekler kredi tüketmez.

Versiyon & Destek

API Versiyonlama

API, URL yolunda versiyon numarası içerir (/api/v1/). Mevcut versiyonlar en az 12 ay desteklenir.

Mevcut Versiyonlar

StableGüncel ve önerilen versiyon

Destek

API ile ilgili sorularınız için destek@aidedektor.com adresine e-posta gönderebilirsiniz.

Başlamaya Hazır Mısınız?

API anahtarınızı oluşturun ve dakikalar içinde entegrasyona başlayın.

API Anahtarı Oluştur Planları İncele