---
title: 聊天补全接口 (Chat Completions)
description: 使用 OpenAI 兼容的 Chat Completions 接口完成多轮对话，并配置模型、消息、流式输出与工具调用。
lastUpdated: 2026-08-04
---

这是平台常用的对话接口，用于与各类语言大模型进行多轮对话交互。接口兼容 OpenAI 常用请求格式，便于接入多数基于 OpenAI 规范开发的客户端与插件。

> **接口端点：** `POST /v1/chat/completions`
> **身份认证：** `Authorization: Bearer 您的API_KEY`

## 核心参数说明表

在发送 POST 请求时，请提供以下参数：

| 参数名称 | 是否必填 | 参数说明 |
| :--- | :--- | :--- |
| **model** | **必填** | 模型 ID，例如 `qwen-plus`。请从模型广场或 `/v1/models` 获取当前可用值。 |
| **messages** | **必填** | 对话的历史记录与当前问题。它是一个列表，每条记录需要包含“角色(role)”和“内容(content)”。角色可以是 system(系统设定)、user(用户提问) 或 assistant(AI 回答)。 |
| **temperature** | 选填 | 采样温度。较低数值通常更稳定，支持范围和默认值由所选模型决定。 |
| **stream** | 选填 | 是否启用流式输出（打字机效果）。设置为 true 时，数据将逐步推送到您的客户端。 |
| **max_tokens** | 选填 | 限制本次回答的最大 Token 数，防止输出过长。 |
| **tools** | 选填 | 外部工具/函数调用列表。如果您希望 AI 能够调用您自己开发的外部插件（如查天气），可在此定义。 |
| **reasoning_effort** | 选填 | 推理强度。仅在所选模型支持时生效，常见值为 `low`、`medium` 或 `high`。 |