跳转到主要内容

常见状态码

常见 base URL 错误

配额错误

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

限流

OmniaKey 支持路由级限流和模型请求限流,上游供应商也可能通过中继返回 429。公开文档不写固定阈值,因为限制可能随路由、账户/分组配置和供应商而变化。 429 当作可重试的限流信号处理:使用指数退避,加入 jitter,不要立刻重复发送同一批突发请求。

不支持的公开端点

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