使用 Python 官方 SDK cozepy 调用扣子（Coze）工作流（Workflow），这是字节跳动官方维护的包，支持完整的 Coze Open API，包括直接执行工作流（非流式/流式）、带文件上传、恢复中断等功能。
1. 准备工作
- 登录扣子平台：访问 https://www.coze.cn 或 https://www.coze.com（国际版）
- 创建并发布工作流：
- 在工作流画布中搭建好逻辑（支持输入参数、LLM、代码节点、插件等）
- 发布后，复制工作流 ID（通常在 URL 最后一段数字）
- 创建个人访问令牌（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():
()
