1. 文档
  2. 入门
  3. API Key

API Key

同一个 Key 可以调用所有模型、所有协议,用在所有工具里。只有想分别设置额度或分开查看用量时,才需要多建几个。

创建 Key

  1. 在控制台打开 API Key 页面,点击创建 API Key。
  2. 填一个能区分项目或设备的名称,例如 cursor-laptop。
  3. 点击创建。页面会立即显示完整的 Key 和两个 Base URL,都可以一键复制。之后也可以在列表里随时再次复制完整的 Key。

额度上限与有效期

  • 额度上限(美元):这个 Key 最多能花多少。留空表示不限,只受账户余额约束。超出上限后请求返回 401。
  • 过期时间:永不过期、30 天、90 天或自定义日期。过期后请求返回 401。
  • 所有 Key 共用同一个账户余额;列表里会显示每个 Key 的已用金额和上限。

保管与泄露处理

  • 把 Key 放在环境变量里(例如 AIROUTLY_API_KEY),不要写进源代码或提交到代码仓库。
  • 每台设备或每个项目各用一个 Key,需要停用时互不影响。
  • Key 泄露后,立即删除并新建一个。删除后旧 Key 马上失效。