身份验证
了解如何使用 Bearer Token 验证 LEAPERone API 请求、管理 API 密钥，并避免常见的授权错误。
LEAPERone 对模型流量和账户控制面操作使用不同的凭据。
基础 URL
https://api.leaper.one模型 API 密钥（sk-）
调用 /v1/* 下兼容 OpenAI 的模型端点时，请使用 API 密钥，并通过 Authorization 请求头传入：
curl https://api.leaper.one/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'X-API-Key 请求头
也可以使用 X-API-Key 请求头：
curl https://api.leaper.one/v1/chat/completions \
-H "X-API-Key: sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello"}]}'控制令牌（lpc_）
CLI、EnvX、账户自动化、用量查询、工单和组织操作使用 /api/v1/* 下具有明确权限范围的控制令牌。请通过 Dashboard 授权界面登录：
npx @leaperone/cli auth login
npx @leaperone/cli auth status控制令牌具有明确的权限范围，例如 api_keys:read、credits:read、usage:read 或 envx:write。不要长期使用模型 API 密钥代替控制令牌。
创建 API 密钥
你可以通过以下两种方式创建和管理密钥：
Dashboard — 前往 Settings > API Keys，点击 Create Key。
CLI — 在终端中列出现有密钥：
npx @leaperone/cli apikey listAPI 密钥只会在创建时显示一次，请妥善保存。
错误代码
| 状态码 | 含义 |
|---|---|
401 | 凭据无效、已过期、已撤销或缺失。 |
403 | 控制令牌不包含所需权限范围。 |
402 | 余额不足，请充值后继续。 |
完整的错误响应结构请参阅 API 参考。