认证

OneGate 使用 Bearer Token 认证。每次请求需要在 Authorization 头中携带 API Key。

请求头

Authorization: Bearer sk-og-xxxxxxxxxxxxxxxx
Content-Type: application/json

在 SDK 中配置

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ONEGATE_API_KEY"],
    base_url="https://onegate.club/v1",
)

API Key 管理

• 每个账户可创建多个 Key，建议按环境（production / dev / ci）划分。
• Key 创建后只展示一次，请立即保存到密钥管理器或 CI Secret。
• Key 一旦泄露请立即在控制台撤销并重新生成。
• 默认无 IP / 域名白名单，需要时可在 Key 设置中开启。

每个 Key 的消费限额

daily_limit_cny 和 monthly_limit_cny 控制每个 API Key 的人民币消费准入：NULL 表示不限额，0 会阻止新的可计费请求。

• 日限额和月限额分别按 Asia/Shanghai 自然日、自然月重置。
• 仅统计当前 Key 已提交到 usage_logs.cost_cny 的消费；当 spent >= limit 时拒绝新请求。
• 并发在途请求可能造成小幅越界；该限制不是费用预留或并发硬上限。
• 准入检查适用于 POST /v1/chat/completions 和创建视频任务的 POST /v1/videos/generations。

Anthropic 兼容端点

若使用 @anthropic-ai/sdk 或原生 Messages 协议，请把 base URL 指向：

https://onegate.club/anthropic

认证方式相同（Authorization: Bearer），其余请求体与 Anthropic 官方完全一致。