### 实现文件上传功能的接口设计 为了使 `/v1/workflows/run` 接口能够支持文件传输，通常需要调整请求的内容类型（Content-Type），并允许通过 `multipart/form-data` 的方式发送数据。以下是具体实现方法： #### 请求结构调整 当涉及文件上传时，HTTP 请求头中的 `Content-Type` 应改为 `multipart/form-data`，这使得可以在同一个请求中同时传递二进制文件和其他字段。 以下是一个完整的 Python 示例代码用于演示如何向 `/v1/workflows/run` 发送带有文件的数据[^4]: ```python import requests def upload_file_with_api(file_path, input_text="默认文本"): url = "https://api.dify.ai/v1/workflows/run" # 替换为实际的 API 密钥 api_key = "{YOUR_API_KEY}" headers = { 'Authorization': f'Bearer {api_key}' } files = { 'file': ('example.txt', open(file_path, 'rb')) # 文件名和打开模式需根据实际情况修改 } data = { "inputs": json.dumps({"input": input_text}), "user": "abc-123", "response_mode": "blocking" } response = requests.post(url, headers=headers, data=data, files=files) if response.status_code == 200: return response.json() else: raise Exception(f"Error: {response.status_code}, Message: {response.text}") ``` 上述代码实现了以下几个关键点： 1. **多部分表单编码**：使用 `requests` 中的 `files` 参数来处理文件上传。 2. **JSON 数据嵌套**：对于非文件参数（如 `"inputs"` 和 `"user"` 字段），仍然保持 JSON 格式的字符串化表示，并将其放入普通的 POST 表单字段中[^5]。 #### 注意事项 - 需要确认服务器端是否已配置好接收 multipart 类型的请求以及解析逻辑。 - 如果目标服务不接受额外的自定义键值对，则可能需要进一步咨询文档或联系技术支持团队获取更详细的说明[^6]。 --- ###