Üretim API referansı
DeepSwapAI: AI yüz değiştirme API’si
Fotoğraf, toplu fotoğraf, eşlemeli grup fotoğrafı, video ve GIF yüz değiştirmeyi tek bir üretim arayüzü üzerinden bağlayın. Sözleşmeyi, faturalandırma birimlerini, görev durumlarını ve sınırları burada inceleyin; tüm alanlar ve yanıtlar için eksiksiz İngilizce API referansını açın.
Tek sözleşme, beş iş akışı
HTTPS, multipart yüklemeler ve JSON görev durumları
Yayımlanan her oluşturma rotası bir Bearer API anahtarı kullanır, bir taskId döndürür ve görev durumunu aynı rota üzerinde GET ile sunar.
Doğrudan yanıt
Tek bir API hesabı beş yüz değiştirme girdi türünü kapsar
Fotoğraflar, toplu fotoğraflar, grup fotoğraflarındaki eşlenmiş yüzler, videolar ve GIF dosyaları aynı üretim alan adını ve görev yaşam döngüsünü kullanır. Her istekten önce formatı, boyutu, süreyi, hedef sayısını ve kullanılabilir kredileri doğrulayın; gönderimden sonra taskId değerini kaydedin ve eşleşen GET rotasını yoklayın.
Güncel herkese açık sözleşme
Rotalar, faturalandırma birimleri ve temel sınırlar
| İş akışı | POST rotası | Güncel birim | Temel sınır |
|---|---|---|---|
| Fotoğraf | POST /api/ai-tasks | 6 kredi / çıktı | One source face and one target image |
| Toplu fotoğraf | POST /api/ai-tasks/batch-face-swap | 6 kredi / çıktı | Toplam en fazla 20 girdi görseli; toplam 95 MB |
| Grup eşleme | POST /api/ai-tasks/multi-face-swap | 6 credits / selected face | Up to 10 mapped faces; 95 MB combined |
| Video | POST /api/ai-tasks/video | 3 credits / rounded second; 12 minimum | MP4, MOV, or WebM; 600 seconds; fixed highest 1080p tier |
| GIF | POST /api/ai-tasks/gif | 3 credits / rounded second; 12 minimum | GIF, MP4, or WebM; 30 seconds |
Minimum entegrasyon akışı
Oluşturma görevi göndermeden önce isteği doğrulayın
- 1. API anahtarlarını sunucunuzda tutun; asla bir tarayıcıda, mobil pakette, günlükte veya herkese açık bir depoda bulundurmayın.
- 2. Seçilen iş akışı için multipart alanlarını, dosya türlerini, boyutları, sayıları, süreyi ve kredileri doğrulayın.
- 3. POST isteğini gönderin ve döndürülen taskId değerini beklenen ücretle birlikte kalıcı olarak kaydedin.
- 4. Görev COMPLETED, FAILED veya CANCELLED durumuna ulaşana kadar aynı rota üzerinde GET ile yoklama yapın.
- 5. Sonuçları yalnızca görevin sahibi olan hesaba iletin ve medyayı yayımlanan saklama kuralına göre kaldırın.
Genel sözleşmede idempotency-key alanı belgelenmemiştir. Çağıran hizmet, yinelenen gönderimi devre dışı bırakmalı, ilk taskId'yi kalıcı hale getirmeli ve başka bir POST işlemi yapmadan önce belirsiz bir ağ yanıtıyla mutabakat sağlamalıdır.
Görev yaşam döngüsü
Görev kimliğini koru ve terminal durumunda dur
| Olay | Görev kaydı | Kredi eylemi | İstemci eylemi |
|---|---|---|---|
| Görev kabul edildi | Görev kimliğini ve beklenen maliyeti kalıcı hale getir | Uzlaşmayı sunucuya ait olarak ele al | Ölçülü yoklamaya başla |
| Görev tamamlandı | Terminal sonuç | Tamamlanan işler sabit kalır | Sonuç almayı yetkilendir |
| İşleme başarısız oldu | Terminal hatası | Mevcut sözleşme iadeleri otomatik olarak işlenemiyor | Yeniden göndermeye karar vermeden önce hatayı okuyun |
| Yanıt sonucu belirsiz | Başka bir POST işleminden önce mutabakat sağlayın | Bir zaman aşımından asla tahmin yürütmeyin | Depolanan taskId veya hesap geçmişini kullanın |
Yanıt sonucu belirsiz Genel sözleşmede idempotency-key alanı belgelenmemiştir. Çağıran hizmet, yinelenen gönderimi devre dışı bırakmalı, ilk taskId'yi kalıcı hale getirmeli ve başka bir POST işlemi yapmadan önce belirsiz bir ağ yanıtıyla mutabakat sağlamalıdır.
Faturalandırma, gizlilik ve dışa aktarma
Entegrasyonunuza doğrulanabilir sınırlar yerleştirin
API access requires a verified email and at least one PAID or COMPLETED credit order. Reward and trial credits are limited to the signed-in web workflow and cannot be automated through the API. Each account can create up to 3 API keys, with up to 6 generation requests per minute per key. Failed tasks are refunded under the current rules, and media is deleted within 24 hours.
Geliştirici soruları
Yayına almadan önce bu noktaları doğrulayın
API webhook destekliyor mu?
Şu anda desteklemiyor. POST tarafından döndürülen taskId değerini saklayın ve nihai bir duruma ulaşılana kadar aynı iş akışı rotası üzerinde GET ile yoklama yapın.
Resmi bir SDK var mı?
Şu anda yayımlanmış resmi bir dil SDK'sı bulunmuyor. Standart HTTPS, Bearer kimlik doğrulaması, multipart veriler ve JSON yanıtları, sunucu tarafındaki herhangi bir HTTP istemcisiyle çalışır.
Bir fotoğraf görevi kaç kredi kullanır?
Bir fotoğraf, bir toplu çıktı veya bir grup fotoğrafında seçilen bir yüz şu anda 6 kredi kullanır. Video ve GIF için yukarı yuvarlanan saniyeler ve minimum ücret uygulanır.
API anahtarını ön uç koduna koyabilir miyim?
Hayır. API anahtarlarını sunucuda saklayın ve bunları asla tarayıcı paketlerine, mobil ikili dosyalara, günlüklere, analiz olaylarına veya destek taleplerine yazmayın.
Entegrasyonu tek bir temsili görevle doğrulayın
Toplu işlemlere veya uzun videolara ölçeklendirmeden önce alanları, durumları, ücretleri ve sonuç teslimini en küçük yetkili medya örneğiyle test edin.