身份验证
了解如何使用 Bearer Token 验证 LEAPERone API 请求、管理 API 密钥，并避免常见的授权错误。
LEAPERone 对模型流量和账户控制面操作使用不同的凭据。
基础 URL
https://api.leaper.one模型 API 密钥（sk-）
调用 /v1/* 下需要认证的模型、媒体和数据端点时，请使用 API Key，并通过 Authorization 请求头传入。GET /v1/models 等公共发现端点不需要 Key。
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 密钥代替控制令牌。
非交互式 CLI 自动化请单独设置控制令牌：
export LEAPERONE_CONTROL_TOKEN=lpc-your-control-token
npx @leaperone/cli --json auth status创建 API 密钥
你可以通过以下两种方式创建和管理密钥：
Dashboard — 前往 Settings > API Keys，点击 Create Key。
CLI — 在终端中创建或列出密钥：
npx @leaperone/cli apikey create -n "my-app-key"
npx @leaperone/cli apikey list完整 API Key 只会由 apikey create 显示一次。apikey list 只返回预览，无法找回丢失的完整 Key。请妥善保存新 Key。
错误代码
| 状态码 | 含义 |
|---|---|
401 | 凭据无效、已过期、已撤销或缺失。 |
403 | 控制令牌不包含所需权限范围。 |
402 | 余额不足，请充值后继续。 |
完整的错误响应结构请参阅 API 参考。