1. 项目背景"Dify 的控制台很好用，但我们的业务系统是用 Python 写的后台服务，不能每次都需要人登录网页手动操作。"这是企业集成 Dify 时的典型诉求。Dify 不是只给运营人员点鼠标用的——它提供了完整的 REST API，让你可以通过代码创建 App、管理知识库、发起对话、执行 Workflow。Dify 的 API 体系分为三大类：Console API（/console/api/*）：给管理后台用的，需要 Session 登录态，用于创建 App、配置 Provider 等管理操作。Web API（/api/*）：给 WebApp 前端用的，用于普通用户的对话交互。Service API（/v1/*）：给开发者编程调用的，使用 API Key 鉴权，这是本章的重点。Service API 的设计相当完善——支持 Chat、Completion、Workflow 三种运行模式，支持流式（streaming）和阻塞式（blocking）两种响应方式，支持文件上传、会话管理、知识库查询。有了它，你可以把 Dify 当做一个"LLM 能力中台"——内部所有的业务系统（客服、营销、数据分析）都通过 API 调用 Dify，统一管理模型成本、监控质量。本章将带你通过 Python 代码系统地掌握 Service API 的核心用法，从简单的单次调用到复杂的批量处理和文件上传，并最终用一