---
title: "助手对话"
method: POST
path: "/paas/v4/assistant"
tags: ["助理 API"]
deprecated: true
---

# 助手对话

`POST /paas/v4/assistant`

## Request

- Base URL: `https://open.bigmodel.cn/api`
- URL: `https://open.bigmodel.cn/api/paas/v4/assistant`
- Auth: HTTP bearer

> **Deprecated.**

与`AI`助手进行对话，支持流式和同步模式。点击 **Try it** 按钮可快速试用。

## Request body

- AssistantRequest
  - `assistant_id` '65940acff94777010aa6b796' | '65a265419d72d299a9230616' | '664dd7bd5bb3a13ba0f81668' | '664e0cade018d633146de0d2' | '6654898292788e88ce9e7f4c' | '66437ef3d920bdc5c60f338e' | '659e54b1b8006379b4b2abd6' | '65d2f07bb2c10188f885bd89' | '663058948bb259b7e8a22730' | '65a393b3619c6f13586246cd' | '65b356af6924a59d52832e54' | '668fdd45405f2e3c9f71f832', required: 智能体ID，必需参数。请从下拉框选择智能体： • ChatGLM（官方）- 65940acff94777010aa6b796：嗨~ 我是清言，超开心遇见你！😺 • 数据分析（官方）- 65a265419d72d299a9230616：分析数据并提供图表化 • 复杂流程图（官方）- 664dd7bd5bb3a13ba0f81668：五秒钟做一张流程图 • 思维导图 MindMap（官方）- 664e0cade018d633146de0d2：任何复杂概念秒变脑图 • 提示词工程师（官方）- 6654898292788e88ce9e7f4c：超强结构化提示词专家 • AI画图（官方）- 66437ef3d920bdc5c60f338e：专属绘画伙伴 • AI搜索（官方）- 659e54b1b8006379b4b2abd6：连接全网内容，精准搜索 • PPT助手（官方）- 65d2f07bb2c10188f885bd89：超实用的PPT生成器 • arXiv论文速读（官方）- 663058948bb259b7e8a22730：深度解析论文 • 程序员助手Sam（官方）- 65a393b3619c6f13586246cd：编程开发知识搜索引擎 • 网文写手（官方）- 65b356af6924a59d52832e54：大神写作秘诀 • 英语语法助手（官方）- 668fdd45405f2e3c9f71f832：检查语法和语法解释
  - `conversation_id` string: 会话`ID`，可选参数，用于继续之前的对话
  - `model` 'glm-4-assistant' | 'glm-4-alltools', required: 使用的模型名称
  - `messages` object[], required: 对话消息列表
    - `role` 'user', required: 消息作者的角色
    - `content` union, required
      - string: 消息文本内容
      - object[]: 多模态消息内容，支持文本、图片等
        - `type` 'text' | 'image_url': 内容类型
        - `text` string: 文本内容
        - `image_url` object
          - `url` string: 图片`URL`
  - `stream` boolean: 是否启用流式响应
  - `request_id` string: 请求任务`ID`，长度必须位于`6`到`64`位之间
  - `user_id` string: 终端用户的唯一`ID`，长度必须位于`6`到`128`位之间
  - `do_sample` boolean: 是否稳定输出
  - `attachments` object[]: 附件列表
  - `metadata` object: 元数据信息
  - `extra_parameters` object: 额外参数，用于特定智能体的扩展配置
    - `translate` object: 翻译参数
      - `from` string: 源语言
      - `to` string: 目标语言

## Response `200`

业务处理成功

- AssistantResponse
  - `id` string: 响应`ID`
  - `request_id` string: 请求`ID`
  - `created` integer: 创建时间戳
  - `model` string: 使用的模型
  - `choices` object[]
    - `index` integer
    - `message` ChatCompletionResponseMessage
      - `role` string: 当前对话角色，默认为 `assistant`
      - `content` union
        - string: 当前对话文本内容。如果调用函数则为 `null`，否则返回推理结果。 对于`GLM-4.5V`系列模型，返回内容可能包含思考过程标签 `<think> </think>`，文本边界标签 `<|begin_of_box|> <|end_of_box|>`。
        - object[]: 多模态回复内容，适用于`GLM-4V`系列模型
          - `type` 'text': 回复内容类型，目前为文本
          - `text` string: 文本内容
        - string, nullable: 当使用`tool_calls`时，`content`可能为`null`
      - `reasoning_content` string: 思维链内容，仅在使用 `glm-4.5` 系列, `glm-4.1v-thinking` 系列模型时返回。
      - `audio` object: 当使用 `glm-4-voice` 模型时返回的音频内容
        - `id` string: 当前对话的音频内容`id`，可用于多轮对话输入
        - `data` string: 当前对话的音频内容`base64`编码
        - `expires_at` string: 当前对话的音频内容过期时间
      - `tool_calls` ChatCompletionResponseMessageToolCall[]: 生成的应该被调用的函数名称和参数。
        - `function` object: 包含生成的函数名称和 `JSON` 格式参数。
          - `name` string, required: 生成的函数名称。
          - `arguments` string, required: 生成的函数调用参数的 `JSON` 格式字符串。调用函数前请验证参数。
        - `mcp` object: `MCP` 工具调用参数
          - `id` string: `mcp` 工具调用唯一标识
          - `type` 'mcp_list_tools' | 'mcp_call': 工具调用类型, 例如 `mcp_list_tools, mcp_call`
          - `server_label` string: `MCP`服务器标签
          - `error` string: 错误信息
          - `tools` object[]: `type = mcp_list_tools` 时的工具列表
            - `name` string: 工具名称
            - `description` string: 工具描述
            - `annotations` object: 工具注解
            - `input_schema` object: 工具输入参数规范
              - …
          - `arguments` string: 工具调用参数，参数为 `json` 字符串
          - `name` string: 工具名称
          - `output` object: 工具返回的结果输出
        - `id` string: 命中函数的唯一标识符。
        - `type` string: 调用的工具类型，目前仅支持 'function', 'mcp'。
    - `finish_reason` string
  - `usage` object
    - `prompt_tokens` integer
    - `completion_tokens` integer
    - `total_tokens` integer

## Other responses

- `default`: 请求失败。

## Changes

- **2026-11-03** `7fd61aa7f811`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/changes/paas/v4/assistant/post.md)

---

[API](https://skmtc.dev/bigmodel/apis/zhipu-ai-api.md) - [All operations](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bigmodel/apis/zhipu-ai-api/revisions/f2be7c0fcbb9?raw)