API 参考
错误与限制
AnyInt 同时发布 bearer 风格和 provider 风格的认证模式。如果请求意外失败,请确认你为所调用的路由使用了正确的请求头类型。
常见 HTTP 结果
| 代码 | 含义 | 典型操作 |
|---|---|---|
400 | 请求体无效或缺少字段 | 重试前先验证负载结构 |
401 | 身份验证失败 | 检查你的 API 密钥和请求头格式 |
403 | 因订阅或策略限制而被阻止访问 | 检查权益、模型访问权限或组织策略 |
429 | 达到限制 | 退避后重试、稍后再试,或提升限制 |
503 | 上游临时不可用 | 使用退避重试或改用备用路由 |
实用指南
请求头不匹配
AnyInt 同时发布 bearer 风格和 provider 风格的认证模式。如果请求意外失败,请确认你为所调用的路由使用了正确的请求头类型。
模型访问问题
在将响应视为平台故障之前,请确认:
- 模型 ID 存在
- 该模型已为你的账户启用
- 你的订阅或密钥策略允许使用它
速率和使用限制
限制可能来自:
- 订阅配额
- 按密钥限制
- 团队级策略
- 上游提供商限流
异步工作流
对于视频和 AI Music 路由,不要将初始任务响应视为完成。在认为资源已就绪之前,请轮询任务路由或等待 webhook。
错误响应示例
鉴权失败
{
"error": {
"message": "Invalid or missing API key",
"type": "authentication_error",
"code": "invalid_api_key"
}
}请检查你是否使用了端点家族文档中要求的鉴权请求头。OpenAI 兼容和多数媒体路由使用 Authorization: Bearer <ANYINT_API_KEY>。Anthropic 兼容路由使用 x-api-key: <ANYINT_API_KEY> 和文档中的兼容性请求头。
速率或配额限制
{
"error": {
"message": "Rate limit exceeded",
"type": "rate_limit_error",
"code": "rate_limit_exceeded"
}
}重试前请退避。面向用户的产品应展示临时容量或配额提示,而不是紧密循环重试。
无效请求
{
"error": {
"message": "Missing required field: model",
"type": "invalid_request_error",
"param": "model"
}
}重试前请修正无效请求参数。重复发送同一个无效请求不会成功。
重试指导
| 情况 | 是否重试 | 指导 |
|---|---|---|
| JSON 无效或缺少必填字段 | 否 | 先修正请求体。 |
| API key 无效 | 否 | 先轮换或修正密钥。 |
| 模型对当前账号不可用 | 不要立即重试 | 调用 Models API 并选择可用模型。 |
| 速率或配额耗尽 | 稍后重试 | 使用指数退避或降低并发。 |
| 临时上游故障 | 是 | 使用指数退避并设置最大重试次数。 |
| 流式输出中断 | 通常可以 | 如果操作可安全重复,从应用层重试。 |
| 异步任务仍在处理中 | 轮询,不要重建 | 继续查询任务路由,不要创建重复任务。 |
按系列的说明
- 与 Anthropic 兼容的路由可能会返回请求结构错误,如果
anthropic-version缺失 - 与 OpenAI 兼容的聊天在以下情况下会返回流式分块:
stream为true - AI Music 在其自己的部分中记录了额外的任务和回调状态代码