使用 Python SDK 调用 Coze 工作流详解

通过 Python 调用**扣子（Coze）**的工作流（Workflow），目前最推荐的方式是使用官方提供的 cozepy SDK（Python SDK）。这是字节跳动官方维护的包，支持完整的 Coze Open API，包括直接执行工作流（非流式/流式）、带文件上传、恢复中断等功能。

1. 准备工作

1. 登录扣子平台：访问 https://www.coze.cn 或 https://www.coze.com（国际版）
2. 创建并发布工作流：
   • 在工作流画布中搭建好逻辑（支持输入参数、LLM、代码节点、插件等）
   • 发布后，复制工作流 ID（通常在 URL 最后一段数字）
3. 创建个人访问令牌（Personal Access Token）：
   • 进入「个人空间」→「设置」→「API 密钥」→「创建新密钥」
   • 记录下生成的 pat_xxx…（这就是 Token）
   • 注意：Token 有有效期，过期需重新生成

安装 SDK：

pip install cozepy

2. 基本调用方式（非流式 / 同步）

import os
from cozepy import Coze, TokenAuth, Message

# 初始化客户端（推荐从环境变量读取 Token，安全）
coze = Coze(auth=TokenAuth(os.getenv("COZE_API_TOKEN")))
# 或直接写 TokenAuth("pat_xxxxxxxx")

# 工作流 ID（从 Coze 平台复制）
workflow_id = "你的工作流 ID，例如 7423xxxxxx"

# 输入参数（根据你工作流定义的输入变量）
parameters = {
    "topic": "2025 年 AI 发展趋势",
    "length": "800 字",
    "style": "专业分析"
}

# 执行工作流（同步，非流式）
result = coze.workflows.runs.create(
    workflow_id=workflow_id,
    parameters=parameters,
    # 可选：user_id（自定义用户标识，用于追踪）
    # user_id="user_123"
)

# 打印最终输出
print("工作流执行结果：")
print(result.output)
# 通常是 dict，根据工作流输出节点决定
(, result.output.get(, ))


 (result, ):
     key, value  result.outputs.items():
        ()