身份认证
按各 API 协议的标准方式安全地使用 AnyInt API 密钥。
所有开发者 API 请求都需要有效的 AnyInt API 密钥。请使用客户端协议原生支持的请求头,以便现有 OpenAI、Anthropic 与 Gemini SDK 正常工作。
各协议推荐认证方式
| 协议 | 推荐输入 | 规范 API 基础地址 |
|---|---|---|
| OpenAI 兼容 | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Anthropic Messages | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| Gemini Developer API | x-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_ 密钥在主动轮换或禁用前仍然有效。请完整复制控制台显示的值,不要自行添加或删除前缀。
export ANYINT_API_KEY="your_api_key"安全建议
- 将密钥保存在服务端密钥管理系统或环境变量中。
- 不要把密钥写入前端代码、源码仓库、日志或 URL。
- 为不同应用和环境使用独立密钥。
- 如果密钥可能泄露,请立即轮换。
- 不要将 AnyInt 密钥转发给上游服务商。
测试认证
先查询模型列表,确认密钥有效,再发送推理请求。
curl "https://api.anyint.ai/openai/v1/models" \
--header "Authorization: Bearer $ANYINT_API_KEY"认证失败返回 HTTP 401 及对应协议的错误格式。有效密钥仍可能因余额不足收到 402,或在没有可用服务商时收到 503。
常见错误排查与处理
当 API 调用遇到异常时,请参考下表快速定位原因与解决方案:
| HTTP 状态码 | 典型原因 | 排查步骤与解决方案 |
|---|---|---|
| 401 Unauthorized | API Key 无效、已过期或请求头缺失 | 检查请求头中的 Bearer Token 或 x-api-key 是否完整复制;在控制台 API 密钥页确认密钥是否处于启用状态。 |
| 402 Payment Required | 账户余额不足或月度预算耗尽 | 前往控制台完成账户充值,或在密钥详情中调高月度消费额度限制。 |
| 403 Forbidden | IP 白名单拦截、环境隔离或权限不足 | 检查 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)。 |