AnyInt Docs
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 兼容的聊天在以下情况下会返回流式分块: streamtrue
  • AI Music 在其自己的部分中记录了额外的任务和回调状态代码

On this page