创建 API Key

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

创建步骤

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

推荐命名方式:

Development
Production API
Codex Laptop
OpenClaw Agent

请求认证

将 API Key 作为 Bearer Token 发送:

curl https://api.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 限制为所需模型
  • 定位异常用量来源

下一步