Dokümantasyon

Hatalar / İstek sınırları

Hatalar

HTTP hataları, code ve message içeren bir error nesnesine sahiptir. Başarıyla kabul edilen bir görev daha sonra yine de başarısız olabilir; görevi sorgulayın veya başarısızlık geri çağırmasını işleyin.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Alan	Yapılması gereken
400	`invalid_request`	Yeniden denemeden önce JSON yapısını, eksik istemi, parametre aralığını veya medya URL'sini düzeltin.
401	`invalid_api_key`	Bearer token değerini ve API anahtarının aktif olup olmadığını kontrol edin.
402	`insufficient_credits`	Kredi ekleyin veya görev maliyetini düşürün. Yanıt, gerekli ve mevcut miktarları içerebilir.
403	`forbidden`	Hata mesajında belirtilen hesap düzeyindeki kısıtlamayı kontrol edin.
404	`not_found`	Görev kimliğini ve anahtarın görevin sahibine ait olup olmadığını kontrol edin.
429	`rate_limited`	Yeniden denemeden önce Retry-After başlığında belirtilen süreyi bekleyin.
500	`internal_error`	Hata mesajını ve API günlüklerini inceleyin. Dikkatli bir şekilde yeniden deneyin; istek oluşturmayı tekrar göndermek, faturalandırılabilir başka bir görev oluşturabilir.

İstek sınırları

Görev oluşturma: Her bir API anahtarı, varsayılan olarak dakikada en fazla 100 isteğe izin verir. Özel istek limitleri şu anda desteklenmemektedir.

Görev sorgulama: Her bir API anahtarı, varsayılan olarak dakikada en fazla 120 isteğe izin verir. Sorgulama istekleri ve görev oluşturma istekleri birbirinden bağımsız olarak sayılır.

Görsel ve video oluşturma istekleri aynı API anahtarı istek sınırını (rate limit) paylaşır.

HTTP 429 hatası, oluşturma için Retry-After: 60 ve sorgular için Retry-After: 5 başlıklarını içerir. Geri çekilme (backoff) yöntemini kullanın ve gereğinden daha sık sorgulama yapmaktan kaçının.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}