Chatflow 应用 API

Chatflow 应用 运行在 advanced-chat 模式下，生成回复的同时流式传输工作流级别的事件（节点开始、完成、迭代）。之前的对话内容会保留为上下文，后续消息可引用更早的内容。

​

发送消息并接收流式回复

• 发送对话消息：向 Chatflow 应用发送用户提问。流式返回时，回复文本之外还会携带工作流和节点事件；阻塞式返回时，运行结束后才返回结果。
• 停止响应：在回复完成前中断流式输出。
• 获取下一轮建议问题列表：回复完成后，基于当前对话内容推荐后续问题。

​

管理会话

• 获取会话列表：按最近活跃时间排序，返回当前用户的会话。
• 获取会话历史消息：返回某个会话的历史消息，适合滚动加载的聊天界面。
• 重命名会话：设置或自动生成会话名称。
• 删除会话：删除指定会话。

​

处理文件

• 上传文件：上传图片、文档、音频或视频文件，供 发送对话消息 引用。文件仅限上传的终端用户使用。

​

语音转写与合成

• 语音转文字：将上传的音频文件（MP3、M4A、WAV、AMR 或 MPGA，最大 30 MB）转写为文字，让终端用户用语音代替打字输入。
• 文字转语音：将回复合成为语音。

​

查看工作流运行

• 获取工作流执行情况：根据 workflow_run_id 查询某次运行的状态与输出，该 ID 出现在对话回复附带的工作流和节点事件中。
• 获取工作流日志：返回运行级别的汇总信息（状态、token 用量、步骤数、耗时），而非逐节点的执行日志。

​

获取应用信息与配置

• 获取应用基本信息：返回应用的名称、描述和标签。
• 获取应用参数：返回调用需在 inputs 中传入的字段（名称、类型、默认值），以及应用的功能开关，可据此构建请求或客户端界面。
• 获取应用元数据：返回工具图标等配置元数据。

​

收集反馈

• 提交消息反馈：终端用户将回复评为 like 或 dislike，并可附加文字说明。