文档 · 核心 API

Chat Completions

POST /v1/chat/completions。请求体与响应体与 OpenAI 一致。可显式指定模型，例如 gpt-4o、claude-3.5-sonnet、deepseek-v3、qwen3-235b-a22b；也可以传 model="auto" 让网关挑。

§ 01

最小请求

curl https://api.cdgo.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-cdgo-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3.5-sonnet",
    "messages": [
      {"role":"system","content":"You answer in one short sentence."},
      {"role":"user","content":"What is a key pool?"}
    ],
    "temperature": 0.2
  }'

§ 02

常用参数

· model — 显式模型 ID，或 auto / auto:cheap / auto:strong / auto:cn-only。
· messages — OpenAI 标准消息数组
· temperature · top_p · max_tokens — 与 OpenAI 同名同义
· response_format — text / json_object，跨厂商生效
· tools · tool_choice — 工具调用，详见下一页
· cdgo — cdgo 私有扩展字段，可设置回退链 / 成本上限 / 缓存策略，详见 /docs/routing。

§ 03

响应体

与 OpenAI 一致；额外多出一个 cdgo 命名空间，包含路由结果、缓存、上游用时与折算后的 USD 成本。

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "claude-3.5-sonnet",
  "choices": [{ "message": {"role":"assistant","content":"..."}, "finish_reason":"stop" }],
  "usage": { "prompt_tokens": 28, "completion_tokens": 96, "total_tokens": 124 },
  "cdgo": {
    "route":      "claude-3.5-sonnet",
    "upstream":   "anthropic-us-east",
    "fallback":   0,
    "cache":      "miss",
    "cost_usd":   0.00163,
    "request_id": "req_01HXZ..."
  }
}