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.
常见状态码
| 状态码 | 含义 |
|---|---|
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，不要立刻重复发送同一批突发请求。