API Görev Sınırı#

Üretim API'ları asenkron görev işleme kullanır. Bir görev başarıyla oluşturulduğunda, API bir taskId döndürür. Görev durumunu, ilerlemeyi, kuyruk konumunu ve nihai çıktıyı kontrol etmek için sonuç uç noktasını kullanın.

Bu belge, API entegrasyonları için kamuya açık görev sınırlarını, dakika başına istekleri, tamamlanmamış işleri ve birden fazla görev gönderildiğinde kredilerin nasıl tahsil edildiğini açıklar.

---

Hız Sınırı Özeti#

Üretim API'ları, görev oluşturma için sabit bir kamuya açık dakika başına istek sınırı kullanmaz. Pratik sınır, bir hesabın aynı anda kaç tamamlanmamış işe sahip olduğuna dayanır.

Tamamlanmamış işler hem kuyruktaki hem de çalışan işleri içerir.

30-iş sınırı, bir kredi paketi veya ücretsiz kota değil, bir görev sayısı sınırıdır. Her kabul edilen üretim görevi, o API'nin kredi kurallarına göre tahsil edilir.

---

Görev Durumu#

Sonuç uç noktası, bekleyen bir görevin kuyruk konumunu gösteren waitNumber'ü de döndürebilir. Bir görev çalışırken veya bittiğinde, waitNumber genellikle 0'dır.

---

AI 3D Görevleri#

AI 3D görevleri seferinde birer işlenir.

Birden fazla AI 3D görevi gönderebilirsiniz ve her başarılı gönderim bir taskId döndürür. Ancak, aynı anda yalnızca bir AI 3D görevi çalışır. Ek AI 3D görevleri, mevcut görev bitene kadar bekler.

Önerilen entegrasyon davranışı:

1. Döndürülen taskId'i kaydedin.
2. Sonuç uç noktasını 3-5 saniye aralıklarla sorgulayın.
3. Unprocessed'ü bekleyen olarak ele alın.
4. Processing'ü aktif olarak çalışan olarak ele alın.
5. Kullanıcılarınıza ilerlemeyi göstermek için waitNumber ve percentage'yi kullanın.

---

Diğer Üretim Görevleri#

AI 3D dışındaki üretim iş akışları için, her hesap aynı iş akışı için en fazla 30 tamamlanmamış iş'e sahip olabilir.

Bu, hesap düzeyinde bir sınırdır. Aynı hesap altında birden fazla API anahtarı oluşturulursa, bunlar aynı sınırı paylaşır.

Bu, her zaman 30 işin tam olarak aynı anda çalıştığı anlamına gelmez. Bazı işler bekliyor olabilir, bazıları çalışıyor olabilir. Sınır her ikisini de sayar.

Hesap zaten bir iş akışı için 30 tamamlanmamış işe sahipse, o iş akışı için yeni görev gönderimleri, mevcut işler bitene kadar geçici olarak reddedilebilir.

---

Krediler ve Tamamlanmamış İşler#

Krediler, bir üretim görevi başarıyla oluşturulduğunda düşülür. Görev nihayetinde başarısız olursa, düşülen krediler otomatik olarak iade edilir.

Tamamlanmamış iş sınırı, her görevin kredi maliyetini değiştirmez. Birden fazla görev gönderirseniz, her kabul edilen görev ayrı ayrı tahsil edilir.

Örnekler:

Tam kredi tablosu için Kredi Düşülmesi Referansı'na bakın.

Sonuç uç noktasını sorgulamak yeni bir üretim görevi oluşturmaz ve tamamlanmamış iş olarak sayılmaz.

---

Geçici Hizmet Meşgul Yanıtları#

Bazı durumlarda, hizmet meşgul olduğu için yeni görev gönderimleri geçici olarak reddedilebilir. Hesabınızda 30'den az tamamlanmamış iş olsa bile bu olabilir.

Bu geçicidir. Kalıcı bir başarısızlık olarak ele almayın.

---

Önerilen İstemci Davranışı#

1. Döndürülen her taskId'yi kaydedin.
2. Görev durumunu düzenli aralıklarla sorgulayın.
3. Hesap ve iş akışı başına tamamlanmamış işlerin yerel bir listesini tutun.
4. Durum Success veya Failed olduğunda işleri tamamlanmamış listesinden çıkarın.
5. AI-3D olmayan iş akışları için, daha fazla göndermeden önce tamamlanmamış işleri 30'de veya altında tutun.
6. 9015 veya 5020 alırsanız, bir gecikme sonrası yeniden deneyin.

Önerilen yeniden deneme davranışı:

---

Daha Yüksek Verimlilik Gerekli mi?#

Standart hesap ve iş akışı başına 30 tamamlanmamış iş sınırı entegrasyon ihtiyaçlarınızı karşılamıyorsa, [email protected] adresinden bizimle iletişime geçin. Kullanım durumunuzu inceleyebilir ve daha yüksek verimlilik veya özel bir düzenleme seçeneklerini tartışabiliriz.

---