Docs / API 密钥

API 密钥

API 密钥用于为你发往 RelayRouter API 的请求鉴权。每次调用都需要在 Authorization 请求头中携带有效密钥。

#创建 API 密钥

打开 RelayRouter 控制台
进入 API 密钥页面并创建一个新密钥
复制你的新密钥并妥善保存

请像对待密码一样对待密钥。如果某个密钥可能泄露，请在控制台中删除它并创建一个新的。

#为请求鉴权

在每次请求中以 bearer token 的形式携带你的 API 密钥：

Authorization: Bearer YOUR_API_KEY

例如，使用对话补全端点：

terminalbash

curl https://relayrouter.io/v1/chat/completions \
  -H "Authorization: Bearer $RELAYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

同一个密钥在所有端点上通用。任何兼容 OpenAI 的工具也都接受它：把基础 URL 设为 https://relayrouter.io/v1（保留 /v1 后缀），再粘贴你的密钥即可。

#安全最佳实践

切勿分享你的 API 密钥，或将其提交到版本控制系统
将其保存在环境变量中：export RELAYROUTER_API_KEY="..."
把任何包含密钥的 .env 文件加入 .gitignore
定期轮换密钥：删除旧密钥并创建新密钥
为开发和生产使用不同的密钥
在控制台中监控用量，以发现异常活动

#密钥管理

在控制台中管理密钥：

操作	说明
`创建`	按需生成新的 API 密钥
`删除`	吊销不再需要或可能已泄露的密钥
`查看用量`	按密钥监控用量与花费

#速率限制

每个密钥都适用标准速率限制。如果你收到 429 Too Many Requests：

在请求之间加入短暂延迟
重试时采用指数退避
如需更高的限额，请联系 support@relayrouter.io