Skip to main content
API 密钥让服务器和 CLI 可以调用咏唱引擎网关，也能下载需要认证的模型包。完整生命周期包括创建、使用、轮换和吊销。

​
何时使用 API 密钥

服务器到服务器调用网关或模型下载接口时，用 API 密钥。用户作用域的操作（计费、账户设置、会话管理）用会话 JWT。
1

打开 API 密钥页面

登录并打开 /dashboard/api-keys（或在 ariacompute.cn 上的对应页面）。
2

创建密钥

点击 创建，输入一个描述性名称（例如 production、ci 或 laptop），然后提交。
立即复制 key。它只在这一次响应里返回；控制台和后续的 GET /api/api-keys 调用只显示 prefix。
3

使用密钥

把完整值作为 Bearer 令牌发给网关或下载接口。
4

列出密钥

返回每个密钥的 id、name、prefix、created_at 和 last_used_at。
5

吊销密钥

返回 204 No Content，密钥立即失效。

​
轮换

定期轮换密钥，或在密钥可能已暴露时立即轮换：
  1. 创建新密钥并存入密钥管理器。
  2. 与旧密钥一同部署新密钥。
  3. 等待日志确认全部流量已使用新密钥。
  4. DELETE 旧密钥。

​
按站点隔离的密钥

API 密钥的作用域是签发它的站点。如果你同时使用 ariacompute.com 和 ariacompute.cn，就在两个控制台各创建一个密钥，分别用于对应的网关。
给密钥取有意义的名字，比如短前缀加环境（prod-api、staging-worker）。吊销时一眼就能认出来。
不要把 API 密钥提交到代码仓库，也不要贴进客户端 JavaScript。拿到密钥的人都能花光你的钱包。

​
相关