创建 API Key

API 请求通过 GetRouter API Key 认证。建议为每个应用或工具创建独立 API Key,方便统计用量和单独撤销权限。

创建步骤

  1. 登录 GetRouter
  2. 打开 API Keys 页面
  3. 点击创建 API Key
  4. 输入可识别应用的名称,例如 CodexOpenClawDevelopment
  5. 根据需要设置过期时间、使用额度或模型限制。
  6. 创建后,将 API Key 复制到安全位置。

推荐命名方式:

Development
Production API
Codex Laptop
OpenClaw Agent

请求认证

将 API Key 作为 Bearer Token 发送:

curl https://getrouter.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

在工具的 API Key 输入框中,除非工具明确要求,否则不要在真实 Key 外添加引号。

安全保存

本地开发时,可以将 API Key 放入环境变量:

export GETROUTER_API_KEY="YOUR_API_KEY"

应用从环境变量读取:

import os

api_key = os.environ["GETROUTER_API_KEY"]
Danger

不要将 API Key 提交到 Git、写入浏览器端代码或发送到公开问题中。如果 Key 已泄漏,请立即删除并创建新 Key。

使用独立 Key

独立 Key 可以帮助你:

  • 撤销一个工具而不影响其他应用
  • 设置不同用量限制
  • 将 Key 限制为所需模型
  • 定位异常用量来源

下一步