> ## 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.

# Kimlik Doğrulama

> OpenAI, Anthropic ve Gemini protokollerinde tek ön ödemeli API anahtarıyla OmniaKey isteklerini doğrulayın.

Her OmniaKey API isteği [API Keys dashboard](https://omniakey.com/dashboard/tokens)
üzerinden alınan bir API anahtarı kullanır.

## Bearer token

Evrensel biçim Authorization header'ıdır:

```bash theme={null}
Authorization: Bearer your-omniakey-api-key
```

Bu biçimi cURL, OpenAI uyumlu client'lar ve çoğu custom entegrasyon için
kullanın.

## SDK kuralları

Resmi SDK'ler farklı auth biçimleri kullanır. OmniaKey çağrılan protokol için
yaygın biçimleri kabul eder.

| SDK veya protokol | Auth biçimi                                            |
| ----------------- | ------------------------------------------------------ |
| OpenAI SDK        | `api_key` / `Authorization: Bearer`                    |
| Anthropic SDK     | `api_key` / `x-api-key`                                |
| Gemini SDK        | `api_key` / `x-goog-api-key` / `?key=` query parameter |

Custom entegrasyonlarda `Authorization: Bearer` tercih edin. Belgelenen tüm
endpoint'lerde tutarlı çalışır.

## Anahtarları ayrı tutun

Yerel geliştirme, CI ve paylaşılan ekip iş akışları için ayrı anahtarlar oluşturun.
Bu, sızan bir anahtarı döndürmeyi ve anahtar bazlı harcama limitleri koymayı
kolaylaştırır.

## Yaygın auth hataları

| Status | Anlamı                                       | Çözüm                                         |
| ------ | -------------------------------------------- | --------------------------------------------- |
| `401`  | Anahtar eksik, pasif veya geçersiz           | Dashboard'da anahtar oluşturun veya döndürün  |
| `403`  | Anahtar limiti veya hesap bakiyesi çok düşük | Anahtar limitini artırın veya bakiye yükleyin |