API 密钥

API 密钥是应用程序向 AnyInt 进行身份验证的主要方式。请将每个密钥都视为生产环境机密，即使它只面向低成本或开发环境。

核心规则

将密钥视为服务器端机密
当所有权变更时轮换密钥
开发、预发布和生产环境使用不同的密钥
一旦怀疑泄露，立即撤销并重新创建密钥

常见的请求头样式

请使用该端点系列所需的请求头样式：

Authorization: Bearer <ANYINT_API_KEY>

或

x-api-key: <ANYINT_API_KEY>

兼容 Anthropic 的路由还需要：

anthropic-version: 2023-06-01

订阅密钥行为

基于订阅的密钥遵循严格的生命周期：

明文密钥仅在创建或重新生成时返回一次
之后的查看内容应仅显示掩码后的密钥
重新生成密钥应立即使旧密钥失效
过期的订阅应自动使其密钥失效

当前的订阅产品设计还会通过前缀区分计划密钥和自定义密钥，例如 sk-plan-* 和 sk-custom-*。

密钥与计费的关系

根据您的账户配置，使用您的 API 密钥发出的请求可能会计入：

预付费按量付费余额
计划订阅
自定义订阅

这意味着密钥管理与计费模式是相互关联的。当您轮换或重新生成密钥时，请确保使用该密钥的环境也与预期的计费模型保持一致。

存储与处理指南

切勿在浏览器代码中暴露密钥
将密钥存储在密钥管理器或部署平台环境变量中
尽可能按工作负载给密钥添加标签
在内部运行手册中保留可见前缀，以便操作人员识别正在使用的是哪一个密钥

环境设置示例

export ANYINT_API_KEY="your-anyint-api-key"

然后在请求中使用它：

curl https://api.anyint.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","stream":false,"messages":[{"role":"user","content":"你好"}]}'

常见错误

在开发、预发布和生产环境中重复使用同一个密钥
将机密存放在前端应用中
忘记某些路由使用 x-api-key 而不是 Authorization: Bearer
重新生成密钥却未更新每个依赖环境