算汇开发者文档

文本对话

POST /v1/chat/completions 的请求地址、常用参数、响应结构和流式选项。

本页内容

POST/v1/chat/completions

发送一组对话消息，并返回模型生成的下一条回复。不同模型支持的参数可能不同；模型不支持的扩展参数应从请求中移除。

请求体

字段	类型	必填	说明
`model`	string	是	模型 ID，以模型广场或 `/v1/models` 返回值为准
`messages`	array	是	按顺序排列的对话消息
`stream`	boolean	否	为 `true` 时使用 SSE 流式返回
`temperature`	number	否	控制输出随机性；有效范围由模型决定
`top_p`	number	否	核采样参数，通常不与 `temperature` 同时大幅调整
`max_tokens`	number	否	限制最大输出 token 数，具体上限由模型决定

每条消息至少包含 role 与 content。常见角色为 system、user 和 assistant。

非流式请求

curl

bash

curl https://本站域名/v1/chat/completions \
-H "Authorization: Bearer sk-您的密钥" \
-H "Content-Type: application/json" \
-d '{
  "model": "deepseek-chat",
  "messages": [
    {"role": "system", "content": "回答要简洁。"},
    {"role": "user", "content": "什么是 SSE？"}
  ],
  "temperature": 0.7
}'

成功响应的核心字段：

字段	说明
`id`	本次生成的标识
`model`	实际调用的模型名称
`choices`	候选回复；通常读取第一项
`choices[0].message.content`	模型回复正文
`usage`	本次请求的 token 用量

流式请求

请求体加入 "stream": true。客户端会收到 data: 开头的 SSE 事件，正文增量通常位于 choices[0].delta.content。完整处理方式见流式输出。

请求体#

非流式请求#

流式请求#

请求体

非流式请求

流式请求