> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniakey.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hatalar ve Rate Limitler

> Yaygın OmniaKey API hata yanıtları, kota hataları ve rate-limit sorun giderme.

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

| Status | Anlamı                                                                                |
| ------ | ------------------------------------------------------------------------------------- |
| `400`  | Geçersiz request body, desteklenmeyen alan veya hatalı parametre                      |
| `401`  | Eksik veya geçersiz API anahtarı                                                      |
| `403`  | Hesap bakiyesi, API anahtarı limiti, model erişimi veya policy kısıtı isteği engeller |
| `404`  | Yanlış path, yanlış base URL eki veya bilinmeyen model id                             |
| `429`  | OmniaKey veya upstream provider throttling                                            |
| `500`  | OmniaKey veya upstream provider hatası                                                |

## Base URL hataları

Kurulum hatalarının çoğu yanlış protokol ekinden gelir:

| Araç veya SDK           | Doğru base URL                    |
| ----------------------- | --------------------------------- |
| OpenAI uyumlu           | `https://api.omniakey.com/v1`     |
| Anthropic / Claude Code | `https://api.omniakey.com`        |
| Gemini native           | `https://api.omniakey.com/v1beta` |

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](https://omniakey.com/dashboard/tokens) 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.