创建 API 密钥
在控制台「API 密钥」创建密钥,可设置消费上限与过期时间;密钥只在创建时完整展示一次。
调用接口前需要先创建一把 API 密钥(Key)。密钥在控制台「API 密钥」页创建和管理,同一账户可以创建多把,按用途分开使用。
创建步骤
- 登录后进入控制台,左侧导航选择 API 密钥。
- 点击「创建密钥」,填写:
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 名称 | 必填 | 按用途命名,便于区分,例如 production、test |
| 消费上限(美元) | 可选 | 该密钥的累计消费上限,留空表示不限制 |
| 过期日期 | 可选 | 到期后密钥自动失效,留空表示长期有效 |
- 提交后创建成功,弹窗中会完整展示一次密钥——请立即复制并妥善保存。
密钥的安全展示约定
- 完整密钥只在创建时展示这一次,关闭弹窗后无法再次查看。
- 密钥列表中始终以打码形式显示(保留前缀与末 4 位),防止旁观泄露。
- 忘记或丢失密钥:删除该密钥并重新创建即可,新密钥立即可用。
安全建议
- 不要把密钥写进前端代码、公开仓库或聊天消息——任何拿到密钥的人都能消耗你的余额。
- 按环境拆分密钥(生产 / 测试各一把),并为生产密钥设置消费上限,把风险圈定在可承受范围。
- 怀疑泄露时立即删除该密钥并重建;删除立即生效,使用旧密钥的调用会收到 401。
- 需要临时授权他人使用时,创建独立密钥并设置较小上限,用完即删,不要共享自己的主密钥。

