文档 · 入门

鉴权与 Key

每个请求需要在 Authorization 头带上 Bearer Token。Key 在控制台按项目划分，可绑定预算上限、模型白名单与 IP allowlist。

§ 01

Bearer Token

curl https://api.cdgo.ai/v1/models \
  -H "Authorization: Bearer sk-cdgo-..."

§ 02

Key 的属性

作用域: 项目（不可跨项目）
预算: 日 / 月度上限，单位 USD
模型白名单: 可锁定到指定模型 ID 或别名
速率: 默认 60 req/s · 200k TPM；Pro/Enterprise 可解除
IP allowlist: CIDR 白名单，最多 32 段
撤销: 即时；缓存最多 30 秒生效

§ 03

BYOK：自带上游 Key

Pro 与 Enterprise 支持把你自己的 OpenAI / Anthropic / Google Vertex Key 注入到项目里。路由器、审计、回退仍然可用； BYOK 流量不收 6% 网关费，按 ¥0.001 / req 计费。

curl https://api.cdgo.ai/v1/projects/{id}/upstream \
  -H "Authorization: Bearer sk-cdgo-admin-..." \
  -H "Content-Type: application/json" \
  -d '{
    "vendor": "openai",
    "label":  "my-azure-openai-eastus",
    "secret": "sk-..."
  }'

§ 04

响应头中的鉴权信号

x-cdgo-key-id: 命中的 Key ID（脱敏）
x-cdgo-budget-remaining: 当月剩余 USD
x-cdgo-rate-limit: 当前 req/s 上限
x-cdgo-policy: 命中的合规策略（如有）