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

# Ошибки и rate limits

> Частые ошибки OmniaKey API, лимиты и диагностика Base URL.

| Status | Что означает                                                                                       |
| ------ | -------------------------------------------------------------------------------------------------- |
| `400`  | Некорректный запрос                                                                                |
| `401`  | API key отсутствует или недействителен                                                             |
| `403`  | Не хватает баланса, достигнут лимит API key, нет доступа к модели или сработала policy restriction |
| `404`  | Неверный path, Base URL или model ID                                                               |
| `429`  | Throttling на стороне OmniaKey или upstream provider                                               |
| `500`  | Ошибка OmniaKey или upstream provider                                                              |

Правильные Base URLs:

| Протокол                | Base URL                          |
| ----------------------- | --------------------------------- |
| OpenAI-compatible       | `https://api.omniakey.com/v1`     |
| Anthropic / Claude Code | `https://api.omniakey.com`        |
| Gemini-native           | `https://api.omniakey.com/v1beta` |

## Ошибки лимитов

`403` может означать, что баланс аккаунта слишком низкий или достигнут лимит
расходов API key. Проверьте оба значения в
[личном кабинете](https://omniakey.com/dashboard/tokens).

## Rate limits

OmniaKey поддерживает throttling на уровне маршрутов и запросов к моделям.
Upstream providers тоже могут вернуть `429` через relay. В публичных docs нет
фиксированных порогов: лимиты могут зависеть от route, account/group
configuration и провайдера.

Считайте `429` retryable throttling signal: повторяйте запрос с exponential
backoff, добавляйте jitter и не отправляйте тот же burst сразу ещё раз.

## Unsupported endpoints

Если endpoint не описан в API Reference, считайте его неподдерживаемым для
публичного использования. Это относится к image generation, audio, embeddings,
rerank, files, fine-tuning и batches.