使用 Python 调用 Dify API 获取知识检索结果及溯源信息

本文介绍了如何使用 Dify HTTP API 实现聊天问答功能，支持文本和图文交互。主要包含三个核心接口：上传文件获取 ID、发送聊天消息（可携带图片）和删除会话。

脚本提供了极简封装类 DifyChat，包含安全响应解析和可选会话管理功能。使用时需配置 API 地址、密钥和用户标识，支持纯文本问答和图文问答两种模式，并详细说明了流式输出、多用户适配等扩展场景的实现方法。

一、Dify 聊天示例脚本说明

本脚本演示了如何通过 Dify HTTP API 进行聊天问答，并可选携带图片。核心流程：

1. 上传文件（可选）
   • 调用 /v1/files/upload 上传本地图片，得到 upload_file_id。
   • 只有在需要图文问答时才上传；纯文本时可跳过。
2. 发送对话消息
   • 调用 /v1/chat-messages，必填 query，可选传 files（当有 upload_file_id 时）。
   • response_mode = "blocking" 表示同步等待完整答案；如需流式可改为 "streaming" 并按 SSE 解析。
3. 删除会话（可选）
   • 调用 DELETE /v1/conversations/{id}；返回可能是 204 空 body，因此需要容错解析。

1.1、代码结构

• DifyChat：极简封装，包含 upload_file、send、delete、create_chat（可选）。
• _safe_parse_response：统一解析响应，优先尝试 JSON；否则返回状态码和文本，避免 JSONDecodeError。
• 示例入口：根据 image_path 是否存在，选择纯文本或图文问答，并打印答案。

1.2、快速使用

1. 配置：
   • api_url: 你的 Dify 服务地址（到 /v1）。
   • api_key: Dify 应用的 API Key（通常以 app- 开头）。
   • user: 请求用户标识，用于配额和会话归属。

可选删除会话：

if ret_send.get("conversation_id"):
    ret_delete = chat.delete(ret_send["conversation_id"])
    print(ret_delete)

图文问答：

ret_upload = chat.upload_file("xxx.jpg")
file_id = ret_upload["id"]
ret_send = chat.send("你的问题", file_id=file_id)
print(ret_send.get("answer"))

纯文本问答：

chat = DifyChat(api_url, api_key)
ret_send = chat.send()
(ret_send.get())