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

# 错误和限流

> OmniaKey API 常见错误码、配额问题和 base URL 排查。

## 常见状态码

| 状态码   | 含义                              |
| ----- | ------------------------------- |
| `400` | 请求体或参数不合法                       |
| `401` | API key 缺失或无效                   |
| `403` | 账户余额、API key cap、模型权限或策略限制阻止了请求 |
| `404` | 路径、base URL 后缀或模型 id 错误         |
| `429` | 触发 OmniaKey 或上游供应商限流            |
| `500` | OmniaKey 或上游供应商错误               |

## 常见 base URL 错误

| 工具/SDK                  | 正确 base URL                       |
| ----------------------- | --------------------------------- |
| OpenAI 兼容               | `https://api.omniakey.com/v1`     |
| Anthropic / Claude Code | `https://api.omniakey.com`        |
| Gemini 原生               | `https://api.omniakey.com/v1beta` |

## 配额错误

遇到 `403` 时，同时检查账户余额和 API key 的单 key cap。

## 限流

OmniaKey 支持路由级限流和模型请求限流，上游供应商也可能通过中继返回 `429`。公开文档不写固定阈值，因为限制可能随路由、账户/分组配置和供应商而变化。

把 `429` 当作可重试的限流信号处理：使用指数退避，加入 jitter，不要立刻重复发送同一批突发请求。

## 不支持的公开端点

如果某个端点没有写在 API 参考里，就不要把它当成公开能力使用。当前最常见的例子是图片、音频、embeddings、rerank、files、fine-tuning 和 batches。