---
title: "什么是 Chat Completions API？/v1 对话补全接口详解 | BroadRouter"
description: "Chat Completions API 接收一组带角色标记的消息，返回模型的回复。请求和响应如何工作，以及为什么那么多服务商都沿用它。"
url: https://broadrouter.com/zh/glossary/chat-completions-api/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。[阅读英文原文](https://broadrouter.com/glossary/chat-completions-api/)（2026-11-16 更新）。

# Chat Completions API（对话补全接口）

更新于 2026-11-16

Chat Completions API 是 OpenAI 的 HTTP 端点 POST /v1/chat/completions，它接收模型名称和一组带角色标记的消息，返回模型的下一条消息。它的请求与响应结构已成为 OpenAI 兼容服务商和各类 SDK 通用的格式。

又称： 对话补全接口、聊天补全 API、chat 接口、Chat Completions、chat completions endpoint、/v1/chat/completions、chat.completions.create

外面绝大多数大模型代码说的都是同一种“方言”：一组消息进去，一条消息出来。这种方言就是 Chat Completions API。

## 工作原理

你向 `/v1/chat/completions` POST 一段 JSON，带上 `model` 和 `messages` 数组。每条消息有一个 `role`（`system`、`user`、`assistant` 或 `tool`）和 `content`。回复中有一个 `choices` 数组；每个 choice 带一条 `message` 和一个说明生成为何结束的 [finish\_reason](https://broadrouter.com/zh/glossary/finish-reason/)，另外还有一个记录 token 数量的 `usage` 块。

```bash
curl https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"broadnet/gemma-4-26b-a4b",
       "messages":[{"role":"system","content":"Answer in one line."},
                   {"role":"user","content":"What is a token?"}]}'
```

在 OpenAI Python SDK 中，同样的调用写作 `client.chat.completions.create(...)`。可选字段用来调整输出：`max_tokens`、`temperature`、`stream`、`tools`、`response_format` 等。

这个 API 是无状态的。OpenAI 的迁移指南说，在 Chat Completions 中 “conversation state must be managed manually”（译文：对话状态必须手动管理）：由你的代码保存历史，并在每一轮重新发送。OpenAI 更新的 Responses API 使用带类型的条目，可以在服务端保存状态，OpenAI 也建议在其平台上的新项目使用它，但同时说明 Chat Completions “remains supported”（译文：仍受支持）。

## 为什么重要

-   **可移植性。** [OpenAI 兼容 API](https://broadrouter.com/zh/glossary/openai-compatible-api/) 通常指的就是这个端点。更换服务商往往只需要换一个 [base URL](https://broadrouter.com/zh/glossary/base-url/)、密钥和模型名。
-   **成本。** 因为每次都要重发整段历史，输入 token 每一轮都在增长。长对话要裁剪或做摘要。
-   **字段差异。** 兼容服务商并不都接受 OpenAI 的每个字段。未知字段可能被忽略，也可能被拒绝，所以要测试你依赖的那些字段。

## 在 BroadNet Inference 上

BroadNet 在 `https://inference.broadnet.ai/v1` 上通过 POST /v1/chat/completions 提供对话服务，支持 DeepSeek V4.1 Flash、[GLM 5.3](https://broadrouter.com/zh/models/glm-5.3/)、[Qwen3.8 27B](https://broadrouter.com/zh/models/qwen3.8-27b/) 和 [Gemma 4 VL 26B](https://broadrouter.com/zh/models/gemma-4-vl-26b/)。[流式输出](https://broadrouter.com/zh/glossary/streaming/)使用 `stream=true`，并以 `data: [DONE]` 结束。工具调用和结构化输出只对 GLM 5.3 和 Qwen3.8 27B 有文档说明。BroadNet 的 [API 参考文档](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-chat-completions-api&utm_content=body)没有说明 Responses 端点，所以请使用 Chat Completions。可以从 [curl 快速入门](https://broadrouter.com/zh/guides/curl-quickstart/)或 [Python SDK 指南](https://broadrouter.com/zh/guides/openai-python-sdk/)开始。

## 常见错误

-   只发送最新一条用户消息，却指望模型记得之前的对话。
-   不查对方的参考文档，就把 OpenAI 独有的字段照搬到另一家服务商。

## 常见问题

### Chat Completions API 被弃用了吗？

没有。OpenAI 的迁移指南说 "Chat Completions remains supported"（译文：Chat Completions 仍受支持），同时建议在 OpenAI 上的新项目使用更新的 Responses API。

### Chat Completions API 会记住之前的消息吗？

不会。它是无状态的。OpenAI 的指南说对话状态 "must be managed manually"（译文：必须手动管理），所以每次请求都要发送完整的消息历史。

### BroadNet Inference 的对话用哪个端点？

在 base URL https://inference.broadnet.ai/v1 下的 POST /v1/chat/completions。BroadNet 没有说明有 Responses API 端点。

## 另请参阅

-   [OpenAI 兼容 API（OpenAI-compatible API）](https://broadrouter.com/zh/glossary/openai-compatible-api/)（术语）
-   [Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)（术语）
-   [流式输出（streaming）](https://broadrouter.com/zh/glossary/streaming/)（术语）
-   [finish\_reason（结束原因）](https://broadrouter.com/zh/glossary/finish-reason/)（术语）
-   [工具调用（tool calling / function calling）](https://broadrouter.com/zh/glossary/tool-calling/)（术语）
-   [系统提示词（system prompt）](https://broadrouter.com/zh/glossary/system-prompt/)（术语）
-   [图像 token（image tokens）](https://broadrouter.com/zh/glossary/image-tokens/)（术语）
-   [用 curl 首次调用 BroadNet Inference API](https://broadrouter.com/zh/guides/curl-quickstart/)（指南）
-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/)（指南）
-   [对话补全的流式输出，以及连接中断的处理](https://broadrouter.com/zh/guides/streaming-chat-completions/)（指南）
-   [从 OpenAI API 迁移：Python、Node 和 cURL 代码实战](https://broadrouter.com/zh/blog/migrate-from-openai-api-code-walkthrough/)（文章）
-   [迁移到 OpenAI 兼容 API：切换服务商检查清单](https://broadrouter.com/zh/blog/openai-compatible-api-migration-checklist/)（文章）

用你的真实业务负载试一试。新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-chat-completions-api&utm_content=page-cta) ·

**来源**

-   [OpenAI API 参考：创建对话补全（2026-11-15 查阅）](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI：迁移到 Responses API（2026-11-15 查阅）](https://developers.openai.com/api/docs/guides/migrate-to-responses)
-   [BroadNet Inference API 参考（2026-11-15 查阅）（英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-chat-completions-api&utm_content=sources)
