概述

Chat Completions 是最常用的对话接口。它接收一组 `messages`，返回模型生成的 assistant 消息；当 `stream` 为 `true` 时，响应以 SSE chunk 逐段返回。

UOUODUO Gateway 兼容主流 OpenAI SDK，也会把请求、模型、路由、token 和成本写入控制台日志。

请求

`POST https://api.example.com/v1/chat/completions`

Headers

Body 参数

示例

curl https://api.example.com/v1/chat/completions \
  -H "Authorization: Bearer $UOUODUO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "你是一个简洁的生产环境助手。" },
      { "role": "user", "content": "用三点总结本周上线风险。" }
    ],
    "temperature": 0.3
  }'

响应

同步响应

{
  "id": "chatcmpl_abc",
  "object": "chat.completion",
  "created": 1779483000,
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "1. ..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 80,
    "total_tokens": 112
  }
}

流式响应

设置 `"stream": true` 后，服务端会返回 `text/event-stream`。每个事件以 `data:` 开头，最后以 `data: [DONE]` 结束。

data: {"id":"chatcmpl_abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"第一"},"finish_reason":null}]}

data: {"id":"chatcmpl_abc","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"点"},"finish_reason":null}]}

data: [DONE]

如果设置 `stream_options.include_usage=true`，结束前可能会额外返回一个包含 `usage` 的 chunk；如果网络中断，最终 usage chunk 可能收不到，请以 `/app/logs` 为准。

错误

注意事项

• Vision 输入需选择支持图像的模型，并用 content parts 传入 `image_url`。
• 工具调用时模型可能返回不完整 JSON，服务端应对 `tool_calls[].function.arguments` 做校验。
• 不同供应商对 `seed`、`reasoning_effort`、`response_format` 的支持并不完全一致。
• 控制成本时优先设置 `max_completion_tokens`，并在 `/app/usage` 按 key 或 project 观察趋势。