Platform

Hatalar

Hatalar, çağırdığınız uç noktanın biçiminde JSON olarak döner, anlaşılır bir mesaj ve OpenAI tarzı uç noktalarda programların kullanabileceği sabit bir kod içerir.

Yapı

OpenAI tarzı uç noktalar
{
  "error": {
    "message": "This API key can't use `gpt-6-astra`. It's limited to gpt-6-sol. Change that at https://zurelay.com/app/keys.",
    "type": "permission_error",
    "param": "model",
    "code": "model_not_allowed"
  }
}

/v1/messages üzerinde aynı hatalar, kod içermeyen Anthropic biçiminde gelir: HTTP durumunu ve error.type: { "type": "error", "error": { "type": "...", "message": "..." } } bilgisini kullanın. Hata olsun veya olmasın, her sohbet, görsel ve video yanıtında bir x-request-id başlığı bulunur.

Kodlar

DurumKodNe yapmalısınız
400invalid_requestİsteği düzeltin: message sorunun ne olduğunu, param ise nerede olduğunu belirtir.
400unsupported_contentModel bu dosya türünü okuyamıyor. Dosyayı kaldırın veya okuyabilen bir model seçin.
400invalid_urlİstekteki bir bağlantı indirilemedi. message, bağlantının döndürdüğü durum kodunu içerir.
400invalid_imageBir girdi görseli kullanılamadı (tür, boyut veya bağlantı nedeniyle).
400image_not_generatedModel istemi reddetti. Ücret alınmadı.
400context_length_exceededModel, konuşmanın kendisi için çok uzun olduğunu belirtiyor. Konuşmayı kısaltın veya daha uzun bağlamı olan bir model seçin.
400max_tokens_reachedAkışsız bir /v1/messages yanıtı, araç çağrısının ortasında max_tokens sınırınıza ulaştığı için tam bir mesaj değil. Üretilen içerik ücretlendirilir. Daha yüksek bir max_tokens değeriyle yeniden gönderin.
401missing_api_keyAnahtarı Authorization veya x-api-key içinde gönderin.
401invalid_api_keyAnahtar yanlış veya iptal edilmiş.
401expired_api_keyYeni bir anahtar oluşturun.
402insufficient_quotaDevam eden istekleriniz için ayrılan tutar düşüldüğünde bakiyeniz bu isteğe yetmiyor ya da yanıt sırasında tükendi. Faturalandırma bölümünden bakiye yükleyin veya max_tokens değerini düşürerek daha az çıktı isteyin. Otomatik yükleme başlatılmışsa bu, mesajda belirtilir: birkaç saniye sonra yeniden deneyin.
402key_budget_exceededBu istek, devam eden istekler de hesaba katıldığında anahtarın aylık bütçesini aşabilir veya işlem sırasında bütçe sınırına ulaştı. Bütçeyi artırın ya da gelecek ayı bekleyin.
402key_daily_budget_exceededAynı durum anahtarın günlük bütçesi için de geçerli. Bütçeyi artırın veya UTC gece yarısını bekleyin.
403model_not_allowedAnahtarın bu modeli kullanma izni yok.
403ip_not_allowedAnahtar yalnızca başka adreslerden çalışır.
404model_not_foundModeller sayfasından model kimliğini kontrol edin.
404unknown_urlBöyle bir uç nokta yok. Yolu ve temel URL'yi kontrol edin.
404video_not_foundBu çalışma alanında bu kimliğe sahip bir video yok.
404image_not_foundBu çalışma alanında bu kimliğe sahip bir görsel isteği yok (callback_url ile yapılan istekler için GET /v1/images/{id}).
409video_not_readyVideo henüz hazır değil: status değeri completed olana kadar durumunu sorgulayın.
409video_failedVideo oluşturulamadığı için indirilecek bir şey yok. Nedeni hata mesajında belirtilir.
410video_expiredVideo, Kütüphane'den veya 30 günün sonunda silindi.
413too_largeİstek veya bir dosya sınırı aşıyor. Büyük dosyaları bağlantı olarak gönderin.
429rate_limit_exceededretry-after değerinde belirtilen saniye kadar bekleyip yeniden deneyin.
429concurrency_limit_exceededÇalışma alanında zaten aynı anda çalışan 32 istek var. retry-after değerinde belirtilen saniye kadar bekleyip bir istek tamamlandıktan sonra yeniden deneyin.
500server_errorBizim tarafımızda bir sorun oluştu. Yeniden deneyin.
502stream_interruptedKesilen bir akışın son olayı olarak gönderilir. Kesintiden önce iletilen içerik ücretlendirilir, sonrası için ücret alınmaz; yeniden deneyin.
503model_unavailableModel şu anda kullanılamıyor. retry-after değerinde belirtilen saniye kadar bekleyip yeniden deneyin veya akıllı yönlendirmeyi açın. retry-after yoksa ve x-should-retry: false ise model çalışıyor ancak bu isteğe her seferinde hata mesajı döndürüyor: isteği değiştirmeden yeniden göndermeyin.
503server_restartingZurelay, isteğinizi işleyen makineyi yeniden başlatıyor. Hemen yeniden deneyin: isteği başka bir makine işleyecek. Akış başlamadıysa ücret alınmaz; başladıysa kesilen akışlarda olduğu gibi size ulaşan içerik ücretlendirilir.
503storage_unavailableGörsel oluşturuldu ancak iletilemedi. Ücret alınmadı; yeniden deneyin.
503service_unavailableBizim tarafımızda kısa süreli bir sorun oluştu. Yeniden deneyin.

Yeniden deneme

  • Yanıtta x-should-retry: false belirtilmedikçe, retry-after başlığında belirtilen saniye kadar bekleyerek (veya bekleme süresini üstel olarak artırarak) 429 ve 503 hatalarında yeniden deneyin.
  • Diğer 4xx hatalarında isteği değiştirmeden yeniden denemeyin: aynı hatayı alırsınız.
  • Başarısız istekler ücretsizdir, dolayısıyla bir istek başarılı olana kadar yeniden denemek için ücret ödemezsiniz. Yarıda kesilen akışlarda iletilen içerik, nadir görülen x-should-retry: false içeren 503 durumunda ise girdi ücretlendirilir (bkz. Faturalandırma).
  • Resmî OpenAI ve Anthropic SDK'ları, uygun hatalarda sizin için zaten yeniden dener.

Akış sırasında oluşan hatalar

Modelin doğrudan isteğinizle ilgili döndürdüğü hatalar (desteklemediği bir parametre, kendisi için çok uzun bir istem), modelin kendi mesajı ve koduyla 400 veya 422 olarak iletilir.

Akış sırasında oluşan hatalar

Akış başladıktan sonra oluşan bir hata, HTTP durum kodu olarak iletilemez. Bunun yerine son bir hata olayı alırsınız (uç noktanın biçiminde) ve akış sona erer. Girdi ve hata öncesinde size ulaşan çıktı ücretlendirilir; sonrası için ücret alınmaz. Bu durum nadirdir: çoğu sorun ilk token gönderilmeden önce tespit edilir ve istek yeniden denenir.

Bakiye veya anahtar bütçesi işlem sırasında tükenirse akış yine bu tür bir olayla, insufficient_quota, key_budget_exceeded veya key_daily_budget_exceeded ile sona erer. Akışsız bir istekte bunlar işlem sırasında tükenirse, max_tokens sınırına ulaşan bir yanıtta olduğu gibi yazılan kısım kesilmiş olarak döndürülür (finish_reason: "length" veya /v1/messages için stop_reason: "max_tokens"); kod ise x-zurelay-stopped başlığında belirtilir.

Sorunuz mu var, yoksa bir şey mi eksik? Destek ekibimize sorun, genellikle bir dakika içinde e-postayla yanıtlayalım.