Kanıt sınırı
Özel bir altyapı şeması değil, kamu sözleşmesi referansı
Sahipliğin, doğrulamanın, görev durumunun, yeniden denemenin, mutabakatın, teslimatın, silmenin ve kanıtın kendi entegrasyonunuzda nerede bulunması gerektiğine karar vermek için kullanın. Tam çok parçalı alanlar ve yanıtlar için API dokümantasyonu ve OpenAPI 3.1 sözleşmesinikullanın. Yüz yerelleştirme, kimlik aktarımı, sentez, harmanlama ve video tutarlılığı içindeki araştırma kavramları için yapay zeka yüz değiştirmenin nasıl çalıştığını okuyun.
Doğrulanmış genel sözleşme
Beş asenkron iş akışı tek bir kontrol şeklini paylaşır
Her mevcut nesil iş akışı, bir API anahtarı ile Bearer kimlik doğrulaması yapar, çok parçalı medyayı kabul eder, bir döndürür taskIdve aynı rota üzerinde GET ile sahip kapsamlı durumu açığa çıkarır. Tamamlama yoklama kullanır; webhook geri aramaları ve resmi dil SDK'ları şu anda yayınlanmamıştır.
| İş akışı | POST ve yoklama GET | Maliyet birimi | Birincil sınır |
|---|---|---|---|
| Fotoğraf | /api/ai-tasks | Görev başına 6 kredi | Görsel başına 30 MB |
| Toplu fotoğraf | /api/ai-tasks/batch-face-swap | Çıktı başına 6 kredi | 20 görüntü, 95 MB birleşik |
| Eşlenmiş grup fotoğrafı | /api/ai-tasks/multi-face-swap | Değiştirilen yüz başına 6 kredi | 10 eşlenmiş yüz, 95 MB birleşik |
| Video | /api/ai-tasks/video | Sadece yüz, sahne korumalı: 3/s, en az 12 1080p | 600 saniye, 95 MB birleşik yükleme |
| GIF / kısa klip | /api/ai-tasks/gif | Saniye başına 3 kredi, minimum 12 | 30 saniye, 95 MB hedef |
Kesin biçimler, asgari ücretler ve istek alanları için canlı çalışma alanı ile API belgeleri esas alınmaya devam eder. Hesap ve API görevleri doğrulanmış bir e-posta gerektirir, hesap başına aynı anda bir oluşturma etkin olabilir ve tükenen limitler yeniden deneme bilgisiyle HTTP 429 döndürebilir.
Referans mimarisi
Her geri dönülemez karara bir sahip atayın
Giriş ve kimlik
TLS'yi sonlandırın, sunucuda tutulan anahtarı doğrulayın, bir istek ilişkilendirme kimliği atayın ve her görevi bir hesaba bağlayın.
Politika ve doğrulama
İzin durumunu, iş akışı alanlarını, algılanan medya türünü, bayt boyutunu, sayıyı, süreyi, eşlemeyi, hesap hazırlığını ve kredi kullanılabilirliğini kontrol edin.
Görev defteri
Görev kimliğini, sahibini, iş akışını, beklenen ücreti, durum geçişlerini, zaman damgalarını ve uzlaşma sonucunu kontrolü geri vermeden önce kalıcı hale getir.
Sınırlı işleme
İstek kabulünü oluşturmadan ayır, aktif işi sınırla ve yeniden denenebilir taşıma hatalarını geçersiz girdilerden ayırt et.
Uzlaşma
Rezerv, tamamlama ve başarısız görev iade kararları için tek bir atomik yetki kullan ki bir yeniden deneme iki kez ücretlendiremez veya iade edemez.
Teslimat ve silme
Sonuç erişimini görev sahibine yetkilendirin, görsel dışa aktarma hakkını uygulayın ve medyayı belgelenen 24 saatlik zamanlamaya göre kaldırın.
Sekiz adımlı istek sırası
Talep sözleşmesinden kanıt destekli silmeye geçiş yapın
- Genel istek sözleşmesini dondur. Kesin iş akışını seç ve alanları, medya sınırlarını, maliyet birimini ve terminal durumlarını kaydet.
- Yetkilendirme, onay ve hesap hazırlığını kontrol et. API anahtarını sunucu tarafında tut ve medyayı kabul etmeden önce bir izin kararı gerektir.
- Sıraya eklemeden önce medyayı doğrula ve maliyeti hesapla. Pahalı işten önce algılanan türü, boyutu, sayıyı, süreyi, eşlemeyi ve mevcut kredileri incele.
- Bir dayanıklı görev kaydı oluştur. Sahipliği, iş akışını, beklenen ücreti, girdi referanslarını, durumu ve görev kimliğini kalıcı hale getir.
- Sınırlı bir kuyruk arkasında eşzamansız olarak işle. Eşzamanlılığı sınırla ve geçici ile kalıcı hataları sınıflandır.
- Kredileri tam olarak bir kez uzlaştır. Tamamlanan işi kaydet ve belgelenmiş başarısız işleme iade yolunu çift uzlaşma olmadan uygula.
- Sahip kapsamlı durum ve sonuç erişimini açığa çıkar. Ölçülü bir aralıkta yokla ve TAMAMLANDI, BAŞARISIZ veya İPTAL EDİLDİ'de dur.
- Silmeyi zorla ve operasyonel kanıtı sakla. Medyayı zamanlamaya göre kaldırırken yalnızca izin verilen minimum görev, faturalama, güvenlik ve destek kaydını saklayın.
Durum ve uzlaşma
İşleme durumunu para durumundan ayrı tut
| Olay | Görev kaydı | Kredi eylemi | İstemci eylemi |
|---|---|---|---|
| Görev oluşturulmadan önce istek reddedildi | Kabul edilmiş görev yok | Bir ücret çıkarma | İsteği veya hesap durumunu düzelt |
| 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 |
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.
Hata politikası
Yalnızca hata sınıfı izin verdiğinde yeniden deneyin
| Durum | Hata sınıfı | Mimari yanıtı |
|---|---|---|
| 400 | Geçersiz istek veya medya | Alanlar veya medya değişene kadar kalıcı olarak reddedin. |
| 401 / 403 | Anahtar veya hesap hazırlığı | Anahtarı döndürün veya doğrulamayı tamamlayın; döngü yapmayın. |
| 402 | Yetersiz kredi | Kredi ekleyin ve yalnızca onaydan sonra yeni bir görev gönderin. |
| 404 | Yanlış sahip, rota veya taskId | Kimlik ile depolanan görev meta verilerini uzlaştır. |
| 429 | Oran veya aktif oluşturma sınırı | Retry-After sağlandığında buna uy, jitter ekle ve yeniden denemeleri sınırla. |
| 500 | Geçici kabul veya okuma hatası | Sınırlı üstel geri çekilme kullan ve yinelenen gönderimden önce uzlaştır. |
Gözlemlenebilirlik ve güvenlik
Hassas medyayı günlüklere kopyalamadan kontrol kararlarını izle.
Önerilen görev telemetrisi bir korelasyon ID'si, taskId, hesap tanımlayıcısı, iş akışı, temizlenmiş medya gerçekleri, beklenen kredi miktarı, durum geçişleri, yeniden deneme sayısı, hata sınıfı, uzlaştırma olayı ve silme zaman damgasını içerir. API anahtarlarını, yüz görüntülerini, tam yüklenen dosya adlarını, imzalı sonuç URL'lerini veya çok parçalı gövdeleri günlüğe kaydetme. W3C İz Bağlamı önerisi birlikte çalışabilir istek bağlamını tanımlar; bu, DeepSwapAI'nin özel uygulaması hakkında bir iddia değil, bir tasarım seçeneğidir.
Yükleme savunmaları için, kodu çözülmüş dosya adlarını, tespit edilen içeriği, izin verilen formatları, sayıları ve boyutları doğrula; yalnızca tarayıcı tarafından sağlanan Content-Type'a güvenme. OWASP File Upload Cheat Sheet harici güvenlik referansıdır. onay ve ifşa planlayıcısını insan yetkilendirme kapısı için ve Güven Merkezini mevcut kamu hizmet sınırları için kullan.
Toplam sahip olma maliyeti
Yönetilen, kendi kendine barındırılan ve hibriti aynı ölçülen iş yükünde karşılaştır.
Bir API ücretini yalnızca ham GPU kiralama ile karşılaştırma. Önce bir iş yükü penceresini sabitle: iş akışı karışımı, medya süresi ve çözünürlüğü, tepe eşzamanlılık, yeniden deneme oranı, saklama, inceleme hacmi ve gerekli kullanılabilirlik. Ardından her yinelenen ve başarısızlıkla ilgili maliyeti aynı pencereye ata.
| Maliyet boyutu | Yönetilen API | Kendi barındırılan | Hibrit | Toplanacak kanıt |
|---|---|---|---|---|
| İşlem kapasitesi | Yayınlanan görev veya süre ücreti | GPU kiralama veya satın alma, boş alan, ölçekleme ve model çalışma süresi | Dahili taban artı harici taşma veya uzman işleme | Tamamlanan birimler, süre, çözünürlük, eşzamanlılık ve kullanım |
| Mühendislik ve operasyonlar | Entegrasyon, görev kalıcılığı, yoklama, inceleme ve satıcı değişiklik yönetimi | Model sunma, kuyruk, yükseltmeler, kapasite planlaması, dağıtım ve nöbetçi yanıtı | Orkestrasyon, sağlayıcı soyutlaması ve dahili platform sahipliği | Ölçülen mühendislik saatleri, yayın hızı ve nöbetçi yükü |
| Güvenlik ve yönetişim | Uygulama onay kapısı, hesap politikası, inceleme ve kanıt | Tüm denetleme, depolama, silme, erişim kontrolü ve denetim kontrolleri | Her karar için açık bir sahibi olan paylaşılan kontroller | İnceleme dakikaları, yükseltme oranı, saklama kapsamı ve kontrol sahipleri |
| Depolama ve teslimat | Uygulama tarafı girdi, sonuç ve ağ işleme | Girdi, ara, sonuç, yedekleme, çıkış ve silme işlemleri | Dahili kayıtlar artı sınırlı sağlayıcı aktarımları | Saklanan baytlar, aktarım hacmi, saklama süresi ve silme işi |
| Arıza ve güvenilirlik | Yeniden deneme, uzlaştırma, sağlayıcı kesintisi yönetimi ve geçiş maliyeti | Yedeklilik, olay müdahalesi, başarısız işler, kurtarma ve kullanılmayan kapasite | Hem bağımlılık arızası hem de dahili orkestrasyon arızası | Arıza oranı, kurtarma süresi, yinelenen iş ve destek yükü |
Bu çerçeve, kendi barındırılan bir fiyat karşılaştırması yayınlamaz ve yönetilen, kendi barındırılan veya hibritin evrensel olarak daha ucuz olduğunu iddia etmez. Karar, aynı dönem için kanıtlanabilen iş yüküne ve kontrollere bağlıdır.
Yapı kararı
Sahip olmanız gereken kontrollere göre yönetilen, kendi barındırılan veya hibriti seçin
| Model | Sizin sahipliğiniz | Harici bağımlılık | En uygun |
|---|---|---|---|
| Yönetilen API | Onay kapısı, uygulama UX, görev kalıcılığı, yoklama, inceleme ve iş politikası | Yayınlanan API, limitler, fiyatlandırma ve işleme davranışı | Altyapı kontrolü yerine entegrasyon hızına öncelik veren ekipler |
| Kendi barındırılan | Model, GPU kapasitesi, kuyruk, denetleme, depolama, güvenlik, yerleşim, silme ve olay müdahalesi | Model ve altyapı tedarik zinciri | Haklı bir kontrol veya dağıtım gereksinimi ve operasyon kapasitesi olan ekipler |
| Hibrit | Dahili politika, orkestrasyon, denetim kaydı, inceleme ve sağlayıcı soyutlaması | Bir veya daha fazla sınırlı üretim hizmeti | Her model bileşenini işletmeden uygulama düzeyinde kontrole ihtiyaç duyan ekipler |
Kaynaklar ve yöntem
Mevcut ürün gerçekleri artı birincil harici standartlar
DeepSwapAI Ürün Ekibi, 22 Temmuz 2026'da beş genel rotayı, Bearer kimlik doğrulamasını, çok parçalı istekleri, görev durumlarını, yoklama akışını, hata yanıtlarını, eşzamanlılık sınırını, kredi yerleşimini, deneme görüntü hakkını ve 24 saatlik medya silme işlemini kontrol etti. Önerilen kontroller, OpenAPI Şartname 3.1.2, OWASP yükleme kılavuzu, NIST AI RMF 1.0, ve W3C İz Bağlamıtarafından bilgilendirilmiştir. Mevcut ürün ifadelerinin genel tasarım rehberliğinden nasıl ayrıldığı için iddia doğrulama metodolojisine bakın.
Mimari sorular
Genel sözleşmenin neyi belirlediğini ve neyi belirlemediğini bilin
Bu, DeepSwapAI'nin özel üretim mimarisi mi?
Hayır. Bu bir genel sözleşme tasarım referansıdır ve sağlayıcı topolojisini, kuyruk teknolojisini, model yerleşimini, işçi sayısını, dahili ağı veya hizmet düzeyi hedeflerini açıklamaz.
Bir istemci bir görevin bittiğini nasıl öğrenir?
POST tarafından döndürülen taskId'yi saklayın ve COMPLETED, FAILED veya CANCELLED olana kadar aynı iş akışı rotasında GET'i yoklayın. Webhook geri aramaları şu anda yayınlanmamıştır.
API anahtarı istemci koduna yerleştirilebilir mi?
Hayır. Bunu bir sunucu tarafı sırrı olarak ele alın ve tarayıcı paketlerinden, mobil ikili dosyalardan, depolardan, analizlerden, günlüklerden ve destek mesajlarından uzak tutun.
API bir kimliksizlik anahtarı yayınlıyor mu?
Hiçbir kimliksizlik anahtarı alanı belgelenmemiştir. Yinelenen gönderimi önleyin, ilk taskId'yi kalıcı hale getirin ve başka bir POST'tan önce belirsiz yanıtları uzlaştırın.
Bu tasarım verim veya kaliteyi garanti ediyor mu?
Hayır. Bu bir kıyaslama, SLA, doğruluk puanı veya kalite garantisi değildir.