身份验证
了解如何使用 Bearer Token 验证 UnderSky API 请求、管理 API 密钥，并避免常见的授权错误。
UnderSky 对模型流量和账户控制面操作使用不同的凭据。
基础 URL
https://api.undersky.ai模型 API 密钥（sk-）
调用 /v1/* 下需要认证的模型、媒体和数据端点时，请使用 API Key，并通过 Authorization 请求头传入。GET /v1/models 等公共发现端点不需要 Key。
curl https://api.undersky.ai/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.undersky.ai/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_）
/api/v1/* 下的 scoped 控制令牌用于账户自动化、用量查询、工单与组织操作。集成服务端工具时，通过 Dashboard 授权界面获取。
控制令牌具有明确的权限范围，例如 api_keys:read、credits:read、usage:read 或 envx:write。不要长期使用模型 API 密钥代替控制令牌。
若已持有控制令牌，可示例查询余额：
curl -sS https://api.undersky.ai/api/v1/credits/balance \
-H "Authorization: Bearer lpc-your-control-token"创建 API 密钥
在 Dashboard → Settings → API Keys 创建并管理密钥。点击 Create Key 后立即保存完整 sk- 值——它只会显示一次。
完整 API Key 只会显示一次，丢失后无法找回。请妥善保存新 Key。
错误代码
| 状态码 | 含义 |
|---|---|
401 | 凭据无效、已过期、已撤销或缺失。 |
403 | 控制令牌不包含所需权限范围。 |
402 | 余额不足，请充值后继续。 |
完整的错误响应结构请参阅 API 参考。