身份认证

按各 API 协议的标准方式安全地使用 AnyInt API 密钥。

所有开发者 API 请求都需要有效的 AnyInt API 密钥。请使用客户端协议原生支持的请求头,以便现有 OpenAI、Anthropic 与 Gemini SDK 正常工作。

各协议推荐认证方式

协议推荐输入规范 API 基础地址
OpenAI 兼容Authorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Anthropic Messagesx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini Developer APIx-goog-api-key: <AnyInt API Key>https://api.anyint.ai/gemini/v1beta
异步媒体Authorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

为兼容常用客户端,网关也允许各协议使用受支持的 AnyInt 密钥请求头,并在 Gemini 路由接受 key 查询参数。应优先使用请求头,避免凭证进入 URL 或中间层日志。

网关会在服务商路由前消费 AnyInt 凭证,不会把该凭证作为上游服务商密钥转发。无效、过期或已撤销的密钥将被拒绝。

创建密钥

在控制台创建 API 密钥,并将其保存在服务端密钥管理系统或环境变量中。

新签发的 AnyInt 密钥使用 sk- 前缀,后接 52 个 Base64URL 字符(总长度 55 个字符)。已有 ak_ 密钥在主动轮换或禁用前仍然有效。请完整复制控制台显示的值,不要自行添加或删除前缀。

bash
export ANYINT_API_KEY="your_api_key"

安全建议

  • 将密钥保存在服务端密钥管理系统或环境变量中。
  • 不要把密钥写入前端代码、源码仓库、日志或 URL。
  • 为不同应用和环境使用独立密钥。
  • 如果密钥可能泄露,请立即轮换。
  • 不要将 AnyInt 密钥转发给上游服务商。

测试认证

先查询模型列表,确认密钥有效,再发送推理请求。

bash
curl "https://api.anyint.ai/openai/v1/models" \
  --header "Authorization: Bearer $ANYINT_API_KEY"

认证失败返回 HTTP 401 及对应协议的错误格式。有效密钥仍可能因余额不足收到 402,或在没有可用服务商时收到 503。

常见错误排查与处理

当 API 调用遇到异常时,请参考下表快速定位原因与解决方案:

HTTP 状态码典型原因排查步骤与解决方案
401 UnauthorizedAPI Key 无效、已过期或请求头缺失检查请求头中的 Bearer Token 或 x-api-key 是否完整复制;在控制台 API 密钥页确认密钥是否处于启用状态。
402 Payment Required账户余额不足或月度预算耗尽前往控制台完成账户充值,或在密钥详情中调高月度消费额度限制。
403 ForbiddenIP 白名单拦截、环境隔离或权限不足检查 API Key 的工作区权限范围,确认请求 IP 是否在允许的白名单内。
404 Not Found请求路径错误或请求的模型 ID 不存在确认 Base URL 路径是否正确;调用 GET /v1/models 验证模型标识符是否正确。
429 Too Many Requests达到速率限制 (RPM/TPM) 或并发上限降低客户端请求并发;在控制台申请提升限额或配置阶梯重试 (Exponential Backoff)。
502 Bad Gateway上游模型服务商网络异常或响应格式损坏AnyInt 网关会自动尝试多通道故障转移;若持续异常,请在控制台查看请求日志或提交工单。
503 Service Unavailable当前模型所有可用通道均处于排队或熔断状态稍后重试,或在应用中配置同能力备选模型实现高可用容灾。
504 Gateway Timeout上游推理超时(多见于超长思考模型未及时吐出首字)优化 Prompt 长度与最大 Token 上限;客户端配置更长的请求超时;对推理模型建议使用流式输出 (Stream)。