创建并安全使用 API Key
API Key 用于鉴权和归集调用用量。一把 Key 绑定一个分组;你可以按用途设置额度、有效期、限速和 IP 规则,并从“使用密钥”指引获取与当前分组匹配的客户端配置。
开始前准备
- 完成登录,并明确要使用的协议、客户端和运行环境。
- 在模型广场确认目标模型所属的当前分组。
- 为不同应用、环境或团队成员规划独立 Key,便于限额、审计和停用。
不要共享完整 Key:支持人员排障不需要你的完整 Key。若怀疑 Key 泄露,应立即停用并创建新 Key,同时更新使用它的服务端配置。
创建和配置 Key
1. 打开 Key 管理
登录后进入API Key 管理页,选择创建 Key。为 Key 使用能区分项目和环境的名称,例如开发、测试或生产用途。
2. 选择分组
根据目标协议和模型选择当前可用分组。Key 创建后只能调用其分组支持的模型;不要从第三方教程复制已经过期的分组名或模型名。
3. 设置使用边界
按实际需要配置额度、有效期、请求限速和 IP 黑白名单。生产 Key 应采用最小可用权限和合理限额,不要为了排障长期关闭所有限制。
4. 安全保存 Key
按页面提示保存新 Key,并将它放入服务端环境变量或专业密钥管理工具。不要写入浏览器前端、移动端安装包、公开仓库、文档示例或聊天记录。
5. 打开“使用密钥”指引
在 Key 列表中打开“使用密钥”,按页面为当前 Key 和分组实际提供的客户端与操作系统选择配置。这里生成的内容以当前 API 地址和 Key 分组为准;页面未展示的客户端不应仅凭第三方教程推断为可用。
6. 发起最小测试并核对用量
成功标志
- Key 列表中显示新 Key,分组和限制与预期一致。
- “使用密钥”页面会展示当前支持的客户端和操作系统配置。
- 最小请求成功,并能在用量页按该 Key 查到对应记录。
常见问题
一个 Key 能否调用多个模型?
同一分组内通常只需修改请求的 model 字段即可切换模型。实际可用范围以模型广场和 Key 所属分组当前展示为准。
什么时候应该创建多把 Key?
不同应用、环境、团队成员、协议或风险边界应使用独立 Key。这样可以分别设置额度和限速,并在单个 Key 泄露时缩小影响范围。
Key 被拒绝时检查什么?
检查 Key 状态、分组、额度、有效期、速率和 IP 规则,再检查鉴权头、端点及模型归属。错误码排查见错误与计费核对。
能否只查询一把 Key 的用量?
可以在登录后的用量页筛选,也可以使用本站公开 API Key 用量查询页。不要把 Key 提交给第三方查询网站。