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

# Errores y límites

> Errores comunes de la API OmniaKey, quota y troubleshooting de base URL.

| Estado | Significado                                                                |
| ------ | -------------------------------------------------------------------------- |
| `400`  | Solicitud inválida                                                         |
| `401`  | API key ausente o inválida                                                 |
| `403`  | Saldo, límite de API key, acceso al modelo o política bloquea la solicitud |
| `404`  | Path, base URL o model id incorrecto                                       |
| `429`  | Throttling de OmniaKey o del proveedor upstream                            |
| `500`  | Error de OmniaKey o del proveedor upstream                                 |

Base URLs correctas:

| Protocolo               | Base URL                          |
| ----------------------- | --------------------------------- |
| OpenAI-compatible       | `https://api.omniakey.com/v1`     |
| Anthropic / Claude Code | `https://api.omniakey.com`        |
| Gemini-native           | `https://api.omniakey.com/v1beta` |

## Errores de quota

Un `403` puede significar saldo insuficiente o límite por API key alcanzado.
Revisa ambos en el [Dashboard](https://omniakey.com/dashboard/tokens).

## Límites de tasa

OmniaKey ofrece throttling por ruta y por solicitud de modelo, y los proveedores
upstream también pueden devolver `429` a través del relay. La documentación
pública no publica umbrales fijos porque los límites pueden variar por ruta,
configuración de cuenta/grupo y proveedor.

Trata `429` como una señal de throttling retryable: usa exponential backoff,
añade jitter y evita reenviar el mismo burst inmediatamente.

## Endpoints no soportados

Si un endpoint no aparece en la API Reference, trátalo como no soportado para uso
público. Esto incluye imágenes, audio, embeddings, rerank, files, fine-tuning y
batches.