创建与管理 API 密钥
API 密钥(API Key,也称令牌)用于授权应用调用模型。建议每个应用使用独立密钥,便于控制预算、定位用量和单独停用。
创建密钥
- 打开API 密钥,点击 创建 API 密钥。
- 填写便于识别的名称,例如“个人聊天”或“开发测试”。
- 选择可用分组,并设置符合用途的额度、有效期和模型范围。
- 保存后,使用 复制 API 密钥 或行菜单中的 复制密钥。
- 将完整密钥填入可信客户端的 API Key 字段,或保存在应用服务端的环境变量中。
密钥名称和隐藏后的星号不能用于调用。复制后检查首尾空格与换行;首次测试建议使用较小预算。
获取 API 地址
在同一页面点击 API 地址,复制适合当前网络的接入地址。是否需要追加 /v1,取决于客户端的协议配置,见客户端接入。
设置访问范围
| 设置 | 含义 | 使用建议 |
|---|---|---|
| 有效期 | 到期后不能继续调用 | 测试和临时用途设置较短期限 |
| 额度 | 该密钥允许消耗的预算 | 按应用分配;不会增加账户余额 |
| 模型限制 | 允许调用的模型范围 | 选择当前应用需要的模型 |
| IP 限制 | 允许发起请求的来源地址 | 固定出口服务适合设置;代理和移动网络可能改变出口 |
| 分组 | 决定可用渠道及相关价格 | 与目标模型的可用分组一致 |
“无限额度”表示不设置该密钥自身的额度上限,账户余额和套餐限制仍然有效。
确认密钥可用
按照首次调用查询模型并发送一条短消息,然后在用量日志核对记录。仅能获取模型列表,还不足以证明模型可以正常生成内容。
密钥泄露怎么办
立即停用或删除旧密钥,创建新密钥并更新应用。随后检查异常调用记录,必要时联系支持核对。旧密钥停用不会撤销已经发生的调用。
完整密钥不应出现在截图、公开仓库、网页源码或支持工单中。“安全与访问”中的个人访问令牌 PAT 用于管理 API,普通聊天软件应使用本页创建的模型 API 密钥。