CDgo·AI

文档 · 入门

5 分钟接入

如果你已经在用 OpenAI 的 Python 或 Node SDK，这一页就是你需要的全部。三步：拿 Key、改 base_url、发一次请求。

§ 01

拿一把 Key

在控制台console.cdgo.ai下创建项目，再创建 Key。Key 形如 sk-cdgo-…，可设置月度预算与 IP allowlist。 注册即送 ¥30 测试额度，无需绑卡。

§ 02

改一行 base_url

把已有 OpenAI 客户端的 base_url 指到 https://api.cdgo.ai/v1，把 api_key 替换为你的 sk-cdgo-…。其它代码无需改动。

curl https://api.cdgo.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-cdgo-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto",
    "messages": [{"role":"user","content":"ping"}]
  }'

§ 03

看响应头

每次请求都会带上以 x-cdgo- 开头的运营头：实际命中的模型、是否回退、缓存命中、Trace ID 等。 在调试与提工单时直接附上这几行。

x-cdgo-route:      gpt-4o-mini
x-cdgo-upstream:   openai-us-east
x-cdgo-fallback:   0
x-cdgo-score:      0.42
x-cdgo-cache:      miss
x-cdgo-request-id: req_01HXZ...

§ 04

下一步