创建 API 密钥

在控制台「API 密钥」创建密钥,可设置消费上限与过期时间;密钥只在创建时完整展示一次。

调用接口前需要先创建一把 API 密钥(Key)。密钥在控制台「API 密钥」页创建和管理,同一账户可以创建多把,按用途分开使用。

创建步骤

  1. 登录后进入控制台,左侧导航选择 API 密钥。
  2. 点击「创建密钥」,填写:
字段是否必填说明
名称必填按用途命名,便于区分,例如 production、test
消费上限(美元)可选该密钥的累计消费上限,留空表示不限制
过期日期可选到期后密钥自动失效,留空表示长期有效
  1. 提交后创建成功,弹窗中会完整展示一次密钥——请立即复制并妥善保存。

密钥的安全展示约定

  • 完整密钥只在创建时展示这一次,关闭弹窗后无法再次查看。
  • 密钥列表中始终以打码形式显示(保留前缀与末 4 位),防止旁观泄露。
  • 忘记或丢失密钥:删除该密钥并重新创建即可,新密钥立即可用。

安全建议

  • 不要把密钥写进前端代码、公开仓库或聊天消息——任何拿到密钥的人都能消耗你的余额。
  • 按环境拆分密钥(生产 / 测试各一把),并为生产密钥设置消费上限,把风险圈定在可承受范围。
  • 怀疑泄露时立即删除该密钥并重建;删除立即生效,使用旧密钥的调用会收到 401。
  • 需要临时授权他人使用时,创建独立密钥并设置较小上限,用完即删,不要共享自己的主密钥。