Ana içeriğe atla
OmniaKey mümkün olduğunda protokol uyumlu hatalar döndürür; böylece mevcut SDK hata yönetiminiz çalışmaya devam eder.

​
Yaygın status code’lar

​
Base URL hataları

Kurulum hatalarının çoğu yanlış protokol ekinden gelir: Claude Code /v1/messages gibi bir path çağırıyorsa base URL çıplak host olmalıdır. OpenAI SDK 404 alıyorsa /v1 içerdiğini doğrulayın.

​
Kota hataları

Bir 403 iki anlama gelebilir:
  • hesap bakiyesi çok düşük, veya
  • API anahtarının anahtar bazlı limiti doldu.
Hem hesap bakiyesini hem de anahtar limitini Dashboard içinde kontrol edin.

​
Rate limitler

OmniaKey route-level ve model-request throttling destekler; upstream provider’lar da relay üzerinden 429 döndürebilir. Public docs sabit eşikler yayınlamaz, çünkü limitler route, hesap/grup yapılandırması ve provider’a göre değişebilir. 429 yanıtını retry edilebilir throttling sinyali olarak ele alın: exponential backoff ile retry edin, jitter ekleyin ve aynı burst’ü hemen tekrar göndermeyin.

​
Desteklenmeyen endpoint’ler

Bir endpoint API Referansı’nda belgelenmiyorsa public kullanım için desteklenmiyor kabul edin. En yaygın örnekler image generation, audio, embeddings, rerank, files, fine-tuning ve batches’tir.