调用 API 前必须先获取 API Key
所有 API 请求均需通过 X-API-Key 请求头进行身份认证。没有有效的 API Key,任何端点都无法调用。
如何获取和使用 API Key
API Key 是调用 ImgRoute API 的唯一凭证,所有 API 请求都需要通过 API Key 进行身份认证。
获取 API Key
- 登录 ImgRoute 账户
- 进入 控制台 → 高级设置(
/dash/advanced) - 点击 「生成 API Key」 按钮
- 系统生成唯一密钥,格式为
sk-ir-xxxxxxxxxxxx
使用 API Key
所有 API 请求需在请求头中携带 API Key:
X-API-Key: sk-ir-your-api-key-here
或使用 Bearer 方式:
Authorization: Bearer sk-ir-your-api-key-here
安全注意事项
重要:
- API Key 仅在生成时显示一次,请立即保存
- 请勿将 API Key 暴露在客户端代码(如前端 JavaScript)中
- 不要在公开仓库中提交 API Key
- 如怀疑 Key 已泄露,请立即在控制台中重新生成
管理 API Key
- 查看:登录后进入控制台可查看 Key 的最后几位
- 重新生成:旧 Key 立即失效,需更新所有使用该 Key 的应用
- 限制:每个账户最多持有 1 个有效 API Key