Skip to content
RouteAPI RouteAPI

获取完整 API Key

GET /api/open/v1/keys/:id/key

返回与 查询单个 API Key 相同的 Key 对象，只是 key 为完整的 sk-... 明文，而不是脱敏值。适用于第三方集成需要保存或轮换 Key、又不希望让用户从控制台手动复制的场景。

请求参数

Section titled “请求参数”
参数位置类型必填说明
idpathinteger是Key ID，正整数

请求示例

Section titled “请求示例”
Terminal window
curl https://www.routeapi.ai/api/open/v1/keys/12/key \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"

响应示例

Section titled “响应示例”
{
  "success": true,
  "message": "",
  "data": {
    "id": 12,
    "name": "bot",
    "key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": 1,
    "created_time": 1729000000,
    "accessed_time": 1729000000,
    "expired_time": -1,
    "remain_amount": 10.00,
    "unlimited": false,
    "used_amount": 0.00,
    "model_limits_enabled": false,
    "model_limits": "",
    "allow_ips": ""
  }
}

响应带 Cache-Control: no-store，浏览器与代理都不会缓存明文 Key。字段说明见 Key 对象。

错误

Section titled “错误”
HTTPcode场景
400invalid_requestid 不是正整数
403insufficient_scope管理密钥缺少本接口所需的权限
404not_foundKey 不存在或不属于你
429rate_limited超过每管理密钥的频率限制
429—超过按客户端 IP 的频率限制（敏感接口默认 100 次/20 分钟），响应体可能为空

其他通用错误码见 开放平台 API 错误。

说明

Section titled “说明”
  • 每次成功调用都会写入审计事件（open_api.key.reveal），记录 Key ID、Key 名称与所用管理密钥；明文 Key 不会写入审计或日志。
  • 本接口返回密钥，因此频率限制比普通查询接口更严格。
  • 完整 Key 也会在 创建 API Key 时返回一次。建议在创建时保存，仅在已保存的值丢失或需要轮换时调用本接口。
  • 查询单个 API Key 与 列出 API Key 仍返回脱敏值。