跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

Python API 调用 Coze 工作流及文件上传方法

如何使用 Python API 调用 Coze 工作流。涵盖普通文本输入和文件输入两种场景。文本输入直接传递参数;文件输入需先通过文件上传接口获取 file_id,再将其作为参数传入工作流。提供了完整的 Python 代码示例及 API 地址获取方式。

佛系玩家发布于 2026/3/27更新于 2026/7/2857 浏览
Python API 调用 Coze 工作流及文件上传方法

1. 工作流的输入为普通文本时

在 coze 建立工作流并发布之后,用 API 的方式来调用,python 代码如下:

import requests
import json
# API URL
url = 'https://api.coze.cn/v1/workflow/run'
# Headers
headers = {
    'Authorization': 'Bearer pat_l0jv6QE****', # 替换为真实的 token
    'Content-Type': 'application/json'
}
# 请求数据
data = {
    "workflow_id": "7451****", # 替换为实际的 workflow_id
    "parameters": {
        # 你的工作流的输入
        "input": "你好"
    }
}
response = requests.post(url, headers=headers, data=json.dumps(data))
print(response.status_code)
print(response.json()) # 如果返回的是 JSON 数据

代码中 Authorization 的获取方式:在下图这里添加新令牌,添加后把 token 复制出来,记得前面的 Bearer 别漏了。

workflow_id 的获取方式:打开你的工作流后在浏览器的地址栏可以看到。

文章配图

2. 工作流的输入为文件时

如需将本地文件作为工作流 API 的输入,因为 coze 工作流文件的传递是基于文件 url,所以先要获得文件的 url,可以使用 coze 官方的 文件上传。

方式如下:

curl --location --request POST https://api.coze.cn/v1/files/upload \
 --header "Content-Type: multipart/form-data" \
 --header "Authorization: Bearer pat_*****" \
 --form 'file=@"test/a.jpeg"' 

或者 python 代码方式:

import requests
# Headers
 = {
    'Authorization': 'Bearer pat_******' 
}
def upload_file(file_path):
     = 
    with open(file_path, "rb") as file:
         = {: file}
         = requests.post(url, headers=headers, files=files)
        print(response.status_code)
        return response.json()
 = upload_file()
 = res[][]
print(file_id)
headers
# 替换为真实的 token
url
"https://api.coze.cn/v1/files/upload"
files
"file"
response
res
'test/a.jpeg'
file_id
'data'
'id'

以上方法会将文件上传到 coze 的服务器,返回 file_id(无法得到 url),可以直接将此 file_id 传入到工作流中,只需将工作流的请求参数改成如下形式,以一个简单的图片内容理解工作流为例:

data = {
    "workflow_id": "751******", # 替换为实际的 workflow_id
    "parameters": {
        # 你的工作流的输入
        "question": "请描述图中的内容",
        "image": \"{\"file_id\": \"******\"}\" # 替换为实际的 file_id
    }
}

工作流:

文章配图

文章配图

文章配图

虽然 image 传入的是一个 file_id,在调用工作流时会自动转成 url,要上传其他类型的文件也是同样的方法。

参考文档:https://www.coze.cn/open/docs/developer_guides/workflow_run

目录

  1. 1. 工作流的输入为普通文本时
  2. API URL
  3. Headers
  4. 请求数据
  5. 2. 工作流的输入为文件时
  6. Headers
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 长亭雷池 WAF 部署与实战指南
  • GitHub 学生开发者包认证流程与注意事项
  • 百瑞互联 BR8654A02 蓝牙 6.0 SOC 芯片规格介绍
  • DIPUM 工具箱全景解读:冈萨雷斯数字图像处理 MATLAB 源码分析
  • 使用 GPT4ALL 本地部署 AI 大模型
  • Python3 基本类型运算详解
  • Web 自动化测试入门:从概念到 Selenium 实战
  • AI 使用全攻略:12 个核心方法与实战技巧
  • Diffusion Transformer (DiT):U-Net 换 ViT,应用于视频生成与机器人动作预测
  • SenseVoice Small 语音情感识别:WebUI 使用与二次开发
  • OpenClaw 技术解析:构建 AI 行动型智能体的架构与实践
  • Git 连接失败 fatal: unable to access 错误排查与修复方案
  • 链表的基本概念与结构实现
  • SubtitleEdit Purfview Faster Whisper XXL 引擎安装失败排查指南
  • ROS 2 海龟仿真器运行与 ros2 run 命令详解
  • 修改 WSL2 网络模式为 Mirrored 以使用 Windows 代理
  • 基于 Python Django 的衣物捐赠系统设计与实现
  • RPA 财务机器人十大应用场景与未来趋势
  • 算法实战:机器人摧毁墙壁最大数目的线段树与离散化方案
  • Git 仓库迁移实战:从克隆到镜像推送

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online