📝 RunningHub AI 工作流交互使用手册（workflow 版本）

1. 功能概述

本脚本通过调用 RunningHub AI 平台的 OpenAPI，实现从本地加载工作流 JSON、修改节点信息、上传文件、提交任务并自动查询结果的全流程操作。

主要功能包括：

读取本地工作流配置（JSON 文件）

生成可修改节点信息列表（nodeInfoList）

根据节点类型（图片、文本等）修改节点值

上传图片、音频、视频文件

向 RunningHub 提交任务并实时查询状态

输出最终生成结果的文件链接

✅ 适用于有自定义工作流（workflowId）的高级用户，可在不打开网页的情况下自动执行 AI 工作流。

2. 文件说明与主要函数

💡 主要文件

文件名	功能
workflow.py	主执行脚本
api.json	从 RunningHub 下载的工作流配置文件（包含节点定义）

🔧 核心函数介绍

函数名	功能描述
load_json(file_path)	从本地读取并解析工作流 JSON 文件
convert_to_node_info_list(data)	将 JSON 格式转换为节点信息列表
upload_file(API_KEY, file_path)	上传本地文件（image/audio/video）至 RunningHub
submit_task(workflowId, node_info_list, API_KEY)	提交任务，启动 AI 工作流执行
query_task_outputs(task_id, API_KEY)	轮询任务执行状态并获取结果输出

3. 操作步骤详解

Step 1️⃣：输入必要信息

运行脚本后，系统会提示输入以下信息：

请输入你的 api_key:

说明：在 RunningHub 控制台“API 调用”中可获得。
示例：0s2d1***********2n3mk4

请输入 workflowId:

示例：1980468315921559554
来源于链接末尾：https://www.runninghub.cn/workflow/1980237776367083521?source=workspace

然后输入本地工作流 JSON 文件路径：

输入您的json文件地址(json文件一定要在自己的工作台中获得，获得途径为导出工作流api到本地)：

示例：C:\Users\Mayn\Downloads\api.json

此时脚本会输出工作流中的所有节点信息：

等待node_info_list生成（包含所有可修改的节点）
{'3': {'inputs': {...}}, '4': {...}, '6': {...}, ...}

Step 2️⃣：查看并修改节点

脚本会提示：

请输入 nodeId（输入 'exit' 结束修改）:

输入节点 nodeId（如 10），脚本会展示该节点的所有字段：

🧩 找到节点 10 的字段如下：
(0, {'nodeId': '10', 'fieldName': 'image', 'fieldValue': 'xxx.jpg'})

接着输入要修改的字段名：

请输入要修改的 fieldName:

示例：image

Step 3️⃣：修改字段值

📷 如果是文件类型（image/audio/video）

请输入您本地image文件路径:

示例输入：D:\R.jpg

上传成功后：

等待文件上传中
上传结果: {'code': 0, 'msg': 'success', 'data': {'fileName': 'api/xxx.jpg', 'fileType': 'input'}}
✅ 已更新 image fieldValue: api/xxx.jpg

📝 如果是文本或数值类型

请输入新的 fieldValue (text):

示例输入：1 girl in classroom

✅ 已更新 fieldValue: 1 girl in classroom

可多次修改不同节点，输入 exit 结束。

Step 4️⃣：提交任务

输入完成后，脚本自动提交任务：

开始提交任务，请等待
📌 提交任务返回: {'code': 0, 'msg': 'success', 'data': {...}}
📝 taskId: 1980471280073846785
✅ 无节点错误，任务提交成功。

Step 5️⃣：任务状态轮询

脚本每隔 5 秒查询任务状态：

⏳ 任务运行中...
⏳ 任务运行中...
🎉 生成结果完成！

如果任务失败，会打印详细原因：

❌ 任务失败！
节点 SaveImage 失败原因: 'str' object has no attribute 'shape'
Traceback: [...]

Step 6️⃣：查看结果文件

任务成功后会输出生成文件链接：

🎉 生成结果完成！
[{'fileUrl': 'https://rh-images.xiaoyaoyou.com/f24a6365b08fa3bc02f55cd1f63e74a7/output/ComfyUI_00001_hnqxe_1761016156.png',
  'fileType': 'png',
  'taskCostTime': '35',
  'nodeId': '17'}]
✅ 任务完成！

打开 fileUrl 即可查看 AI 生成的图片。

4. 完整运行流程概览

1️⃣ 输入 API_KEY 和 workflowId
2️⃣ 加载本地 JSON 工作流
3️⃣ 自动生成可修改节点列表
4️⃣ 修改所需节点参数
5️⃣ 上传文件（如图片）
6️⃣ 提交任务至 RunningHub
7️⃣ 轮询任务状态
8️⃣ 获取并打印生成结果链接

5. 示例输出结果

请输入你的 api_key: a0fada**************b2ke21
请输入 workflowId: ***8315921559***
输入您的json文件地址(json文件一定要在自己的工作台中获得，获得途径为导出工作流api到本地)：C:\Users\Mayn\Downloads\api.json

🧩 找到节点 10 的字段如下：
(0, {'nodeId': '10', 'fieldName': 'image', 'fieldValue': 'xxx.jpg'})
✅ 已更新 image fieldValue: api/xxx.jpg

开始提交任务，请等待
📌 提交任务返回: {...}
⏳ 任务运行中...
🎉 生成结果完成!
✅ 任务完成！

6. 小贴士（Tips）

建议使用 Python 3.8+

脚本可直接在终端运行：

Windows 用户注意文件路径需使用双反斜杠 \\

若使用代理或云主机，请确保端口 443 可访问 www.runninghub.cn

工作流完整接入示例

📝 RunningHub AI 工作流交互使用手册（workflow 版本）#

1. 功能概述#

2. 文件说明与主要函数#

💡 主要文件#

🔧 核心函数介绍#

3. 操作步骤详解#

Step 1️⃣：输入必要信息#

Step 2️⃣：查看并修改节点#

Step 3️⃣：修改字段值#

📷 如果是文件类型（image/audio/video）#

📝 如果是文本或数值类型#

Step 4️⃣：提交任务#

Step 5️⃣：任务状态轮询#

Step 6️⃣：查看结果文件#

4. 完整运行流程概览#

5. 示例输出结果#

6. 小贴士（Tips）#