一.对话型应用 API
对话应用支持会话持久化，可将之前的聊天记录作为上下进行回答，可适用于聊天/客服 AI 等。
| 接口 | 功能描述 | 请求示例 |
|---|---|---|
| POST/chat-messages | 创建会话消息。 | |
| POST/files/upload | 上传文件（目前仅支持图片）并在发送消息时使用，可实现图文多模态理解。 支持 png, jpg, jpeg, webp, gif 格式。 上传的文件仅供当前终端用户使用。 | |
| POST/chat-messages/:task_id/stop | 仅支持流式模式。 | |
| POST/messages/:message_id/feedbacks | 消息终端用户反馈、点赞，方便应用开发者优化输出预期。 | |
| GET/messages/{message_id}/suggested | 获取下一轮建议问题列表。 | |
| GET/messages | 滚动加载形式返回历史聊天记录，第一页返回最新 limit 条，即：倒序返回。 | |
| GET/conversations | 获取当前用户的会话列表，默认返回最近的 20 条。 | |
| DELETE/conversations/:conversation_id | 删除会话。 | |
| POST/conversations/:conversation_id/name | 对会话进行重命名，会话名称用于显示在支持多会话的客户端上。 | |
| POST/audio-to-text | 该接口需使用 multipart/form-data 进行请求。 | |
| POST/text-to-audio | 文字转语音。 | |
| GET/parameters | 用于进入页面一开始，获取功能开关、输入参数名称、类型及默认值等使用。 | |
| GET/meta | 用于获取工具icon |
二.文本生成型应用 API
文本生成应用无会话支持，适合用于翻译/文章写作/总结 AI 等。
| 接口 | 功能描述 | 请求示例 |
|---|---|---|
| POST/completion-messages | 发送请求给文本生成型应用。 | |
| POST/files/upload | 上传文件（目前仅支持图片）并在发送消息时使用，可实现图文多模态理解。 支持 png, jpg, jpeg, webp, gif 格式。 上传的文件仅供当前终端用户使用。 | |
| POST/completion-messages/:task_id/stop | 仅支持流式模式。 | |
| POST/messages/:message_id/feedbacks | 消息终端用户反馈、点赞，方便应用开发者优化输出预期。 | |
| GET/parameters | 用于进入页面一开始，获取功能开关、输入参数名称、类型及默认值等使用。 | |
| POST/text-to-audio | 文字转语音。 |
三.Workflow 应用 API
Workflow 应用无会话支持，适合用于翻译/文章写作/总结 AI 等。
| 接口 | 功能描述 | 请求示例 |
|---|---|---|
| POST/workflows/run | 执行 workflow，没有已发布的 workflow，不可执行。 | |
| POST/workflows/:task_id/stop | 仅支持流式模式。 | |
| GET/parameters | 用于进入页面一开始，获取功能开关、输入参数名称、类型及默认值等使用。 |
参考文献：
[1] Dify中的API接口：对话、生成和工作流：https://z0yrmerhgi8.feishu.cn/wiki/Y6qvwPpv3iUp2KkUc5Qck18pnMe