创建与保护 API Key

APIONE API Key 是模型调用凭证，不是控制台登录密码。取得密钥后，在服务端通过请求头发送，避免泄露到浏览器、截图或日志。

创建与保存

1. 登录 APIONE 控制台。
2. 打开 API 密钥页，创建业务使用的密钥。
3. 按控制台可选项设置模型范围、计费分组与有效期。密钥显示后，将完整内容保存到密钥管理器。
4. 用快速开始发送最小请求，确认权限。

分组与权限

密钥选择的分组决定可用模型及对应价格。创建或修改密钥后，先用 GET /v1/models 查询当前可用 ID，再发送业务请求。详见模型查询与分组定价。

请求鉴权

OpenAI 兼容接口使用 Authorization: Bearer YOUR_APIONE_KEY。Anthropic 兼容接口可使用 x-api-key。一次请求只选择一种鉴权凭证，不要同时发送多个鉴权头。

推荐做法

• 为开发、测试、生产分别使用密钥，便于定位用量与轮换。
• 使用环境变量或服务端密钥管理服务，不把密钥放入前端代码或公开配置。
• 日志只记录密钥别名或脱敏标识，不记录完整请求鉴权头。
• 出现泄露时先在控制台停用或撤销旧密钥，再配置新密钥并验证业务恢复；以界面实际提供的管理操作为准。

轮换检查单

部署新密钥后检查健康请求、模型权限和错误率；确认所有实例已切换后处理旧密钥。如果切换失败，不要通过工单或聊天发送真实密钥，请提供请求 ID 和脱敏配置。 相关：用量与费用、联系支持。