创建 API Key

1. 登录 RouterBee。
2. 进入“控制台 → API 密钥”。
3. 点击“创建 API 密钥”。
4. 填写便于识别的名称，例如 video-production。
5. 选择分组、有效期和额度；没有特殊要求时使用 default 分组。
6. 创建后立即复制并安全保存密钥。

推荐配置

使用场景	名称示例	有效期	额度
本地开发	video-dev	7–30 天	设置较低上限
生产服务	video-production	按安全策略	按预算设置
临时测试	video-demo	1 天	最小必要额度

安全要求

• 仅在后端服务中使用 API Key。
• 使用环境变量或密钥管理服务保存。
• 不要把完整密钥写进日志、Git、工单或文档。
• 开发、测试、生产应使用不同密钥。
• 怀疑泄露时立即禁用旧密钥并创建新密钥。

export ROUTERBEE_API_KEY='替换为你的_API_KEY'
test -n "$ROUTERBEE_API_KEY" && echo 'API Key 已设置'

验证 API Key

创建后调用模型列表接口进行最小验证。该接口没有请求体：

curl --silent --show-error --fail-with-body \
  'https://routerbee.com/v1/models' \
  --header "Authorization: Bearer $ROUTERBEE_API_KEY"

成功响应应包含 data 数组。只有出现在 data[].id 中的模型才代表该密钥当前可以调用。

API Key 对任务的访问范围

任务属于创建它的 RouterBee 用户。查询状态和下载内容时仍需携带有效 API Key；同一用户新建的有效密钥可以继续读取该用户的任务，其他用户的 API Key 无法读取。

生产系统应保留任务与 RouterBee 账户之间的关系，并制定密钥轮换流程。