Limitler
İstek sınırları, otomatik yanıt sınırı, sohbet ve mesaj sınırları, saklanan yanıtlar, dosya ve anahtar sınırları.
İstek sınırları
| Anahtar | Sınır |
|---|---|
| Sunucu anahtarı | Anahtar başına dakikada 120 istek, okumalar dahil |
| Tarayıcı anahtarı | Her ziyaretçi adresinden dakikada 30 istek, okumalar dahil. Anahtarın toplamında saatte 1.200 istek ve ayrıca saatte 20.000 okuma |
Okuma, GET ile yapılan her istektir: GET /key, GET /models, saklanan bir yanıtı ya da girdi öğelerini okumak, sohbetin durumunu ve mesajlarını okumak, GET /chat/{id}/stream. Mesaj göndermek (POST /chat/completions, POST /responses, POST /chat), DELETE /responses/{id} ve POST /responses/{id}/cancel saatte 1.200'lük sınıra sayılır.
Tarayıcı anahtarının bu iki saatlik sınırı birbirinden ayrıdır. Ekip yanıtlarını beklerken yapılan okumalar, ziyaretçilerin mesaj göndermesi için ayrılan saatlik sınırdan düşmez; o sınır dolsa da okumalar sürer. Beş saniyede bir okuyan bir pencere saatte 720 okuma yapar, yani bir anahtarla aynı anda yaklaşık 27 ziyaretçi ekip yanıtı bekleyebilir. Daha fazlası için okuma aralığını uzatın: Ne sıklıkla sormalı.
Ziyaretçi adresi IPv4'te adresin kendisi, IPv6'da adresin /64 bloğudur; aynı adresi paylaşan herkes tek ziyaretçi sayılır. Bir tarayıcı anahtarı bir dakika içinde en fazla 2.000 farklı ziyaretçi adresine hizmet eder; bu sayı yalnız o anahtarın yeni ziyaretçilerini bekletir.
Sınırlar kayan pencereyle sayılır. Sınır aşılınca 429 rate_limit_exceeded döner; Retry-After başlığı kaç saniye beklemeniz gerektiğini söyler. GET /files/{id} dışındaki her istek sayılır. Bu yüzden sekme arka plandayken sormayın.
Otomatik yanıt sınırı
API sohbetlerinde asistanın vereceği yanıt sayısı çalışma alanı başına sınırlıdır. Varsayılan sınır saatte 60, günde 300 turdur. Bunun saatte 40, günde 200 turu tarayıcı anahtarlarının payıdır: çalışma alanının bütün tarayıcı anahtarları birlikte en fazla bu kadar tur alır. Geri kalanını yalnız sunucu anahtarlarınız alabilir; sitenizdeki pencere payını doldursa da sunucunuzdan gelen istekler saatte en az 20, günde en az 100 tur yanıt alır. Sonecentral bu sayıları değiştirebilir. Geçerli sayıları GET /key yanıtındaki limits verir.
Sınır, bir kötüye kullanım ya da hatalı bir döngü işletmenizin öteki kanallarını etkilemesin diye vardır; WhatsApp ve öteki kanalların otomatik yanıt sınırları ayrıdır. Tarayıcı anahtarı sitenizin kodunda herkese açıktır; ayrı pay, bu anahtarla gönderilen isteklerin sunucu anahtarlarınızın yanıtlarını tüketmesini önler.
Sınır ya da tarayıcı anahtarlarının payı dolunca asistan yanıt vermez ve istek 429 ai_turn_ceiling alır; x-should-retry: false ve Retry-After: 300 taşır. Sohbet zaten açıksa mesaj ekibinize bir notla ulaşır. Ziyaretçiye ekibin döneceğini söyleyin. Ekibin yanıtını okumak: Asistan yanıt vermediğinde.
Sohbet ve mesaj
| Ne | Sınır |
|---|---|
| Yeni bir ziyaretçi mesajı | 4.000 karakter |
| Tek istekteki yeni ziyaretçi mesajları | 12 |
| Bir sohbetteki ziyaretçi mesajları | 200 |
| Yeni bir sohbete aktarılan önceki mesajlar | Son 40, her biri en fazla 4.000 karakter |
| İstek gövdesi | 1 MB |
| Geliştirici bağlamı | 2.000 karakter, yalnız sunucu anahtarıyla |
Idempotency-Key | 200 karakter; daha uzunu yok sayılır |
| İlk mesajın yeniden denemesinin açtığı sohbete dönmesi | 10 dakika |
| Aynı sohbette aynı anda | Bir tur. İkincisi 409 conversation_busy alır. |
| Sohbet mesajları listesinin bir sayfası | En fazla 100, varsayılan 50 |
Responses
| Ne | Sınır |
|---|---|
| Saklanan yanıtın ömrü | 30 gün |
metadata | 16 anahtar; anahtar en fazla 64 karakter, değer en fazla 512 karakterlik metin; tamamı JSON olarak en fazla 4 KB |
instructions | 2.000 karakter ve JSON olarak 4 KB; tarayıcı anahtarıyla yok sayılır ve saklanmaz |
| Saklanan girdi öğeleri | Yalnız isteğin kendi öğeleri (yeni mesajlar, item_reference, sunucu anahtarıyla system ve developer mesajları): en fazla 40 öğe, JSON olarak toplam en fazla 8 KB, en yeni öğe sığmazsa kısaltılarak; her birinin metni en fazla 4.000 karakter |
Dosyalar
| Ne | Sınır |
|---|---|
| Asistanın paylaşabileceği bir dosya | 32 MB |
| Dosya bağlantısının geçerliliği | 7 gün |
Aynı dosya kimliğinin (file_…) indirilmesi | Saatte 10 |
| Çalışma alanının günlük dosya indirmesi | Varsayılan 2 GiB, UTC gece yarısı sıfırlanır |
| Aynı adresten indirme isteği | Dakikada 120 |
Anahtarlar
| Ne | Sınır |
|---|---|
| Bir çalışma alanındaki etkin anahtarlar | 50; iptal edilenler sayılmaz |
| Bir tarayıcı anahtarının izin verilen siteleri | 20 |
| Anahtar adı | 80 karakter |
Paket ve yapay zekâ kapasitesi
Asistanın API'deki yanıtları paketinizin mesaj ya da yapay zekâ yanıtı hakkından düşmez. Onları yukarıdaki otomatik yanıt sınırı ve Sonecentral'ın bütün çalışma alanlarının paylaştığı yapay zekâ kapasitesi sınırlar.
- Bu kapasite şu an duraklatıldıysa istek
429 assistant_quota_exhaustedalır vex-should-retry: falsebaşlığını taşır: hemen yeniden denemek işe yaramaz. Bu, çalışma alanınızın hakkının bittiği anlamına gelmez. - Paketiniz asistan yanıtlarına açık değilse istek
402 plan_requiredalır.
İki durumda da sohbet zaten açıksa ziyaretçinin mesajı ekibinize ulaşır.
API trafiğinin kendi gönderim sınırı vardır ve işletmenizin WhatsApp gönderimlerini durduramaz: API'de bir taşma olsa bile öteki kanallar çalışmaya devam eder.
Daha yüksek bir sınıra ihtiyacınız varsa Sonecentral'dan bizimle iletişime geçin.