身份认证

按各 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。