Face Swap API

Basit bir REST API ile kendi ürününüze fotoğraf ve video yüz değiştirme ekleyin. Bir iş gönderin, sonucu sorgulayın, barındırılan bir çıktı URL'si alın.

API erişimi her abonelik planına dahildir. İstekler web uygulamasıyla aynı kredileri kullanır: ayrı bir API faturası yoktur.

Nasıl çalışır

  1. 1

    Bir API anahtarı oluşturun

    Herhangi bir plana abone olun, ardından panelinizde API Anahtarları bölümünden bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir, bu yüzden güvenli bir yerde saklayın.

  2. 2

    Medyanızı yükleyin

    Önceden imzalanmış bir yükleme URL'si isteyin, ardından kaynak yüzünüzü ve hedef görsel veya videonuzu bu adrese PUT ile gönderin.

  3. 3

    Değiştirin ve sorgulayın

    Yüz değiştirme işini gönderin, ardından durum succeeded olana kadar görevi sorgulayın ve çıktı URL'sini indirin.

Kimlik doğrulama

API anahtarınızı her istekte x-api-key başlığında gönderin. Anahtarlar hesabınıza aittir ve hesabınızın kredilerini harcar. Anahtarları gizli tutun; sızarsa panelden yenileyin.

x-api-key: adf_YOUR_API_KEY

Uç noktalar

POST /api/v1/uploads

Bir kaynak veya hedef dosya için önceden imzalanmış bir yükleme URL'si oluşturur. Dosyayı aynı Content-Type ile uploadUrl adresine PUT ile gönderin, ardından yüz değiştirme isteğinde url değerini kullanın. Desteklenen türler: JPEG, PNG, WebP, MP4, QuickTime, WebM.

curl -X POST https://aideepfake.io/api/v1/uploads \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fileName": "target.jpg", "contentType": "image/jpeg"}'

# → { "success": true, "data": { "uploadUrl": "...", "url": "https://...", "expiresIn": 600 } }

curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @target.jpg

POST /api/v1/face-swap

Bir yüz değiştirme işi başlatır. Bir görsel değiştirme 15 kredi, bir video değiştirme 20 kredi tutar; web uygulamasıyla aynı fiyatlar. targetType değerini image veya video olarak ayarlayın. İsteğe bağlı alanlar: faceEnhance, frameEnhance, watermark ve videolar için targetDurationSeconds.

curl -X POST https://aideepfake.io/api/v1/face-swap \
  -H "x-api-key: adf_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://.../source.jpg",
    "targetUrl": "https://.../target.jpg",
    "targetType": "image"
  }'

# → { "success": true, "data": { "taskId": "...", "creditsCost": 15 } }

Video sınırları: düz bir değiştirme için en fazla 300 saniye, faceEnhance veya frameEnhance açıkken en fazla 90 saniye. Daha yüksek bir face_swapper_pixel_boost her iki sınırı da kendi maliyetine böler; 1024x1024'te düz bir değiştirme için 120 saniyeye kadar iner.

GET /api/v1/face-swap/{taskId}

Görev durumunu sorgular. status alanı processing durumundan succeeded veya failed durumuna geçer. Başarı durumunda outputUrl barındırılan sonucu içerir. Başarısız işler otomatik olarak iade edilir.

curl https://aideepfake.io/api/v1/face-swap/TASK_ID \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "taskId": "...", "status": "succeeded",
#      "outputUrl": "https://...", "targetType": "image" } }

GET /api/v1/credits

İş göndermeden önce mevcut kredi bakiyenizi ve planınızı okur.

curl https://aideepfake.io/api/v1/credits \
  -H "x-api-key: adf_YOUR_API_KEY"

# → { "success": true, "data": { "credits": 1000, "subscriptionCredits": 985,
#      "oneTimeCredits": 15, "planId": "...", "currentPeriodEnd": "..." } }

Fiyatlar ve kota

API'nin ayrı bir fiyat listesi yoktur. Her istek, abonelik planınızdaki kredileri harcar: görsel değiştirme başına 15 kredi ve video değiştirme başına 20 kredi, tam olarak web uygulamasındaki gibi. Aylık kredi kotanızı planınız belirler.

Planları karşılaştır

Hata kodları

HTTPKodAnlamı
401INVALID_API_KEYAPI anahtarı eksik, geçersiz, devre dışı veya süresi dolmuş.
403API_REQUIRES_SUBSCRIPTIONHesabın aktif aboneliği yok. API'yi kullanmak için bir plana abone olun.
402INSUFFICIENT_CREDITSHesabın bu iş için kredisi yetersiz. Planı yükseltin veya bir kredi paketi satın alın.
400VIDEO_TOO_LONGVideo, seçilen seçenekler için geçerli süre sınırından daha uzun.
429RATE_LIMITEDÇok fazla istek. Yavaşlayın ve kısa bir bekleyişten sonra tekrar deneyin.

Sık sorulan sorular

Face Swap API'yi kim kullanabilir?

Aktif bir abonelik planı olan herkes. Tarayıcıya gelen ücretsiz krediler web uygulamasını kapsar, API'yi değil.

API istekleri ne kadar tutar?

Web uygulamasıyla aynı: görsel değiştirme başına 15 kredi ve video değiştirme başına 20 kredi. İstekler, web kullanımınızla aynı kredi bakiyesinden düşer.

API video yüz değiştirmeyi destekliyor mu?

Evet. targetType değerini video olarak ayarlayın. Düz video değiştirmeleri en fazla 300 saniye kabul eder; yüz veya kare iyileştirmeli değiştirmeler en fazla 90 saniye kabul eder.

Sonucu nasıl alırım?

status değeri succeeded olana kadar GET /api/v1/face-swap/{taskId} adresini sorgulayın. Yanıt, barındırılan sonuç dosyasını gösteren bir outputUrl içerir.

Bir iş başarısız olursa ne olur?

Başarısız işler otomatik olarak iade edilir. Durum yanıtı, nedeni belirten bir error alanı içerir.

Aboneliğim bitince ne olur?

API anahtarlarınız hemen çalışmayı durdurur. Yeniden abone olduğunuzda tekrar çalışmaya başlar: yeni anahtarlara ihtiyacınız yoktur.

Geliştirmeye başlayın

API anahtarınızı oluşturun ve ilk yüz değiştirmenizi dakikalar içinde çalıştırın.

API anahtarı oluştur