Chat Completions

Chat Completions 是当前最常用的 OpenAI 兼容接口。

Endpoint

POST /v1/chat/completions

请求体最小结构

{
  "model": "your-model",
  "messages": [
    { "role": "user", "content": "Hello CodeingForce" }
  ]
}

常用字段

• model：实际要调用的模型标识。
• messages：对话消息数组，至少需要一条用户消息。
• stream：是否开启流式返回。
• 如果你开启 stream，网关会自动补齐 usage 统计，方便后续计费和对账。
• 其他 OpenAI 兼容字段按你当前 SDK 的常规方式透传即可。

返回与错误

• 成功时返回 OpenAI 兼容响应结构。
• 失败时返回 { ok: false, error: { message } }。
• 如果是上游请求返回非 2xx，错误对象里还会额外带 error.upstreamStatus。
• 如果上游服务异常，常见状态码是 502 或 503。

联调建议

• 首次联调用非流式，先确认模型和鉴权都正确。
• 上线前再补一轮流式、超时和失败重试测试。
• 如果你的项目已经接入 OpenAI SDK，一般只需要把 Base URL 和 API Key 切到 CodeingForce。
• 模型名不确定时，先去看 模型列表。