# Chat Completions 基础接口

`POST /v1/chat/completions`

OpenAI Chat Completions 兼容入口。普通对话、流式输出、识图、读 PDF、函数调用、结构化输出、联网搜索都从这里提交。

## 请求格式
使用 `application/json`。必须包含 `model` 和 `messages`。`messages` 是对话数组，常见 role 包括 system、user、assistant、tool。

## 验证顺序
1. 用 `GET /v1/models` 查询当前 Key 可选的模型。
2. 用 `model` + `messages` 发送第一条请求。
3. 边生成边显示时，加 `stream: true`。
4. 识图、工具、JSON Schema 等功能，在同一接口继续加字段。

## 适用位置
- 聊天页。
- 流式输出界面。
- 图文问答。
- 工具调用和 Agent 编排。
- 从 OpenAI SDK 迁移过来的项目。

## 读取结果
非流式请求返回 JSON，结果通常在 `choices[0].message.content`。流式请求返回 `text/event-stream`，客户端按增量事件拼接内容。

## 错误定位
1. 模型不存在：查询模型列表，确认模型 ID 完全一致。
2. 流式没有增量：确认请求头和客户端按 SSE 处理。
3. 工具调用没执行：模型只返回调用意图，需要由应用服务执行工具并回填结果。

Tags: Chat Completions