认证与 Base URL

传递 API Key

所有请求都需要携带 API Key，以下两种方式任选其一：

请求头	示例	适用
Authorization	Bearer sk-volt-...	OpenAI SDK、curl 等大多数客户端
x-api-key	sk-volt-...	Anthropic SDK、Claude Code

Base URL

不同 SDK 对 Base URL 的约定不同：OpenAI 系列需要带 /v1，Anthropic 系列不带。

客户端	Base URL
OpenAI SDK、Codex、大多数兼容工具	https://console.vailgo.cn/v1
Anthropic SDK、Claude Code	https://console.vailgo.cn

Key 的限制

在控制台创建 Key 时可以为它设置：

• 额度上限：这个 Key 累计最多能消费的金额，用完后请求会被拒绝。
• 模型白名单：只允许调用指定的模型。
• 每分钟请求数（RPM）：超出后返回 429，并在 Retry-After 响应头中给出建议的重试秒数。
• 过期时间：到期后自动失效。