Geliştirici rehberi
Hatalar ve kullanım sınırları
API hata kodlarını ve kullanım sınırlarını incele. İsteğini ne zaman düzeltmen, ne zaman bekleyip yeniden göndermen gerektiğini öğren.
Güncellendi:
API hata yanıtlarını JSON olarak döndürür. Hatanın açıklaması detail alanında yer alır.
{ "detail": "quote_id is required for customer generations" }| Alan | Tür | Açıklama |
|---|---|---|
400 | Bad request | Girdi geçersiz, zorunlu bir alan eksik veya girdi için ücret hesaplanamıyor. |
401 | Unauthorized | API anahtarı gönderilmemiş veya geçersiz. |
402 | Payment required | Teklifte belirtilen tutar için kullanılabilir kredin yetersiz. Kredi yükledikten sonra yeniden dene. |
403 | Forbidden | API anahtarının bu işlem için gerekli izni yok. |
404 | Not found | Model veya üretim kaydı bulunamadı. Üretim kaydı başka bir hesaba ait olduğunda da bu yanıt dönebilir. |
409 | Conflict | Teklifin süresi dolmuş, girdi teklifle eşleşmiyor veya aynı Idempotency-Key farklı bir istek için kullanılmış. |
429 | Too many requests | Bir kullanım sınırına ulaştın. Retry-After başlığında belirtilen saniye kadar bekle. X-Limit-Reason, hangi sınıra ulaşıldığını gösterir. |
503 | Unavailable | API’nin bağlı olduğu bir hizmet geçici olarak kullanılamıyor. Yeniden denemeler arasında giderek daha uzun süre bekle. |
Hesap sınırları
Kontrolsüz kullanımı önlemek için hesaplara aynı anda çalışabilecek üretim sayısı ve günlük harcama sınırı uygulanır. Daha yüksek bir sınıra ihtiyacın varsa bizimle iletişime geç.
Kendi harcama sınırını belirle
Harcama sınırları sayfasından saatlik veya 24 saatlik sınır belirleyebilirsin. Bu sınırı aşacak üretim istekleri 429 yanıtıyla reddedilir.
X-Limit-Reason: spend_limit, isteğin harcama sınırı nedeniyle reddedildiğini belirtir. Retry-After, önceki harcamaların ilgili hesaplama döneminin dışında kalmasına kadar beklemen gereken saniyeyi gösterir.
Bu sınırlar stüdyodan ve tüm API anahtarlarından başlatılan üretimleri kapsar. Sınırları yalnızca stüdyodan değiştirebilirsin.
Sonraki bölüm: API referansı →