创建与管理密钥

API Key 用来认证请求并关联使用记录。你在客户端填写的是豆子 API 创建的密钥，不是账号密码。

创建一枚密钥

1. 打开密钥管理，选择创建密钥。
2. 填写容易辨认的名称，例如“个人聊天”或“项目后端”。
3. 根据实际页面选择分组、额度、有效期和模型限制。
4. 保存后复制密钥，粘贴到本机客户端或后端环境变量。

控制台不同版本的字段名称可能略有差异，以实际界面为准。

限制怎么设置

配置	作用	使用建议
分组	影响可访问的渠道、模型和计费规则	与目标模型在控制台展示的分组对应
额度	限制该密钥可消耗的预算	测试和正式项目分别设置
有效期	限制密钥可使用的时间	临时测试完成后停用
模型限制	在启用时缩小可调用模型范围	核对包含目标模型的完整 ID
IP 限制	在启用时限制请求来源	填写实际出口 IP，留意代理与服务器出口

不要为了排查一个错误同时更改所有限制。每次改一项，更容易确认原因。

在请求中使用

OpenAI 兼容 HTTP 请求使用以下请求头。SDK 的 api_key 或 apiKey 只填写密钥本身，SDK 会处理请求头。

Authorization: Bearer YOUR_API_KEY_HERE
Content-Type: application/json

更换或停用

给不同项目分别创建密钥，可以单独查看记录与撤销访问。更换密钥时，先更新应用的密钥配置并验证调用，再停用旧密钥。

如果密钥曾出现在公开仓库、聊天记录或截图里，应立即停用并创建新密钥，随后检查使用日志。

相关文档：接入地址与模型、余额与计费、401 / 403 排查。