Ana Sayfaya Dön

API Dokümantasyonu

VRFY API'sini kullanarak deepfake tespit özelliklerini kendi uygulamanıza entegre edin.

Kimlik DoğrulamaHızlı BaşlangıçEndpoints

Kimlik Doğrulama

Tüm API istekleri için Authorization header'ında Bearer token kullanmanız gerekir. API anahtarınızı Dashboard'tan alabilirsiniz.

Authorization: Bearer YOUR_API_KEY

Güvenlik: API anahtarınızı asla client-side kodda veya public repository'lerde paylaşmayın.

Hızlı Başlangıç

import requests

API_KEY = "YOUR_API_KEY"
API_URL = "https://api.vrfy.app/v1/analyze/image"

# Dosya ile
with open("image.jpg", "rb") as f:
    response = requests.post(
        API_URL,
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"image": f},
        data={"return_heatmap": True}
    )

result = response.json()
print(f"Deepfake: {result['result']['is_fake']}")
print(f"Güven: {result['result']['confidence']:.1%}")

Endpoints

POST/api/v1/analyze/imageGörsel içerik analizi

Parametreler

imagefile | base64zorunluAnaliz edilecek görsel
return_heatmapbooleanopsiyonelIsı haritası döndür (Premium Plus)

Yanıt Örneği

{
  "success": true,
  "result": {
    "is_fake": true,
    "confidence": 0.97,
    "model_detected": "DALL-E 3",
    "analysis_time_ms": 234,
    "details": {
      "ai_generated_probability": 0.97,
      "manipulation_probability": 0.03,
      "artifacts_found": ["texture_inconsistency", "edge_artifacts"]
    }
  }
}
POST/api/v1/analyze/audioSes içerik analizi

Parametreler

audiofile | base64zorunluAnaliz edilecek ses dosyası
formatstringopsiyonelSes formatı (mp3, wav, ogg)

Yanıt Örneği

{
  "success": true,
  "result": {
    "is_fake": false,
    "confidence": 0.92,
    "analysis_time_ms": 456,
    "details": {
      "voice_cloning_probability": 0.08,
      "natural_speech_markers": true,
      "audio_quality": "high"
    }
  }
}
POST/api/v1/analyze/videoVideo içerik analizi

Parametreler

videofile | urlzorunluAnaliz edilecek video
analyze_audiobooleanopsiyonelSes analizini dahil et
frame_intervalnumberopsiyonelAnaliz aralığı (saniye)

Yanıt Örneği

{
  "success": true,
  "result": {
    "is_fake": true,
    "confidence": 0.89,
    "analysis_time_ms": 2341,
    "frames_analyzed": 120,
    "details": {
      "face_swap_detected": true,
      "lip_sync_score": 0.45,
      "temporal_consistency": 0.78,
      "suspicious_frames": [24, 45, 67, 89]
    }
  }
}
GET/api/v1/usageAPI kullanım istatistikleri

Yanıt Örneği

{
  "success": true,
  "usage": {
    "plan": "premium",
    "requests_this_month": 456,
    "requests_limit": 1000,
    "reset_date": "2024-02-01T00:00:00Z"
  }
}

Rate Limitleri

Planİstek/Dakikaİstek/AyMax Dosya Boyutu
Standart51505 MB
Premium301,00025 MB
Premium Plus100Sınırsız100 MB

Hata Kodları

400Bad Request - Geçersiz istek parametreleri
401Unauthorized - Geçersiz veya eksik API anahtarı
403Forbidden - Bu endpoint için yetkiniz yok
429Too Many Requests - Rate limit aşıldı
500Internal Server Error - Sunucu hatası