📝 RunningHub AI 应用 Python 交互操作脚本使用手册

1. 脚本功能概述

这个 Python 脚本可以帮助你：

获取指定 AI 应用（WebApp）的可修改节点信息（nodeInfoList）。

根据节点类型（图片，文本）修改节点值。

上传本地文件到 AI 应用。

提交修改后的任务到 AI 应用。

自动轮询任务状态，直到生成结果。

输出生成结果的文件链接。

简单说：你可以通过这个脚本，把本地文件或者文本发送给 RunningHub AI 应用，让它生成或处理内容，并自动获取结果。

2. 代码介绍

def get_nodo(webappId,Api_Key)

获取 AI 应用的节点列表（nodeInfoList）。

可参考 RunningHub 官方 API 文档的“获取 AI 应用信息示例”。

def upload_file(API_KEY,file_path)

上传本地文件到 RunningHub 服务器（图片）。

可参考官方 API 文档的“上传资源示例”。

def submit_task(webapp_id, node_info_list,API_KEY)

提交 AI 应用任务。

可参考官方 API 文档的“发起任务示例”。

def query_task_outputs(task_id,API_KEY)

查询任务状态（/task/openapi/status已停止维护）与查询任务生成结果。

可参考官方 API 文档的“查询任务生成结果示例”。

main 函数

用户可在控制台与脚本交互，完成从： 获取节点列表 → 修改节点信息 → 提交任务 → 轮询查询任务状态 → 获取任务结果 的整个流程。

3. 用户在控制台操作步骤（详细版）

Step 1：输入 API 信息

脚本首先会提示你输入 API Key 和 WebApp ID，用于获取 AI 应用所需的节点信息。

请输入你的 api_key:

示例：a0fa3e****************345171

请输入 webappId:

示例：1937084629516193794

说明：WebApp 链接为 https://www.runninghub.cn/ai-detail/1937084629516193794，末尾数字即 webappId。

等待脚本获取 nodeInfoList，其中包含所有可修改的节点：

✅ 提取的 nodeInfoList:
[
  {
    "nodeId": "39",
    "nodeName": "LoadImage",
    "fieldName": "image",
    "fieldValue": "a293d89506f9c484f4ea5695f93024a80cd62ef98f4ee4543faba357536b37ec.jpg",
    "fieldType": "IMAGE",
    "description": "上传图像"
  },
  {
    "nodeId": "37",
    "nodeName": "RH_ComfyFluxKontext",
    "fieldName": "model",
    "fieldValue": "flux-kontext-pro",
    "fieldType": "LIST",
    "description": "模型切换"
  },
  {
    "nodeId": "37",
    "nodeName": "RH_ComfyFluxKontext",
    "fieldName": "aspect_ratio",
    "fieldValue": "match_input_image",
    "fieldType": "LIST",
    "description": "输出比例"
  },
  {
    "nodeId": "52",
    "nodeName": "RH_Translator",
    "fieldName": "prompt",
    "fieldValue": "给这个女人的发型变成齐耳短发,",
    "fieldType": "STRING",
    "description": "图像编辑文本输入框"
  }
]

Step 2：选择要修改的节点

生成 nodeInfoList 后，脚本会提示输入节点 ID 和字段名进行修改。

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

示例输入：39

请输入 fieldName:

示例输入：image

脚本会显示选中的节点信息：

选中节点: {'nodeId': '39', 'nodeName': 'LoadImage', 'fieldName': 'image', 'fieldValue': 'a293d8...', 'fieldType': 'IMAGE', 'description': '上传图像'}

Step 3：修改节点值

3.1 IMAGE 类型

脚本提示：

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

示例输入：D:\R.jpg

上传成功后，脚本返回文件信息并自动更新节点值：

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

3.2 STRING 类型

脚本提示：

请输入新的 fieldValue (STRING):

示例输入：给这个男人的发型变成齐耳短发

返回更新结果：

✅ 已更新 fieldValue: 给这个男人的发型变成齐耳短发

3.3 LIST 类型

脚本提示：

请输入新的 fieldValue (LIST):

示例说明：fieldData里面选择列表里面一个index的值更新到fieldValue里面

返回更新结果：

✅ 已更新 fieldValue: 1:1

可以循环修改多个节点，直到输入 exit 结束。

其他的节点信息修改步骤和示例修改的节点信息步骤一致

Step 4：提交任务

完成节点修改后，脚本自动提交任务：

开始提交任务，请等待
📌 提交任务返回: {'code': 0, 'msg': 'success', 'data': {'taskId': '1979110509284917250', ... ,'promptTips': '{"result": true, "error": null, "outputs_to_execute": ["36"], "node_errors": {}}'}}}
如果promptTips中node_errors不为空，说明有节点出错了
⚠️ 节点错误信息如下：
node_errors{}
📝 taskId: 1979110509284917250

说明：taskId 用于查询任务状态和获取结果。
说明: 如果promptTips中node_errors不为空，说明有节点出错了

Step 5：轮询任务状态

脚本会自动每隔 5 秒查询一次任务状态：

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

SUCCESS → 任务完成

有failedReason → 任务失败

其他状态 → 等待中

Step 6：获取生成结果

任务完成后，脚本输出结果链接：

🎉 生成结果完成！
https://rh-images.xiaoyaoyou.com/f24a6365b08fa3bc02f55cd1f63e74a7/output/ComfyUI_00001_vpvtp_1760691733.png

直接打开链接即可查看生成文件。

⚡ 小贴士

文件路径格式

Windows 用户使用：D:\path\to\file.jpg

网络问题

上传或提交任务可能因网络慢导致失败，可重试。

一次修改多个节点

循环输入 nodeId + fieldName + 新内容，输入 exit 结束循环。

文件类型处理

IMAGE → 自动上传文件

STRING → 直接输入文本

LIST → 直接在fieldData里面选择列表里面一个index的值更新到fieldValue里面

4. 使用流程总结

输入 api_key 和 webappId

获取 nodeInfoList

循环修改节点

提交任务

自动轮询状态

获取生成结果文件链接

完全通过 Python 脚本操作 RunningHub AI 应用，无需在网页上手动操作，非常适合批量处理任务。

AI应用完整接入示例

📝 RunningHub AI 应用 Python 交互操作脚本使用手册

1. 脚本功能概述

2. 代码介绍

3. 用户在控制台操作步骤（详细版）

Step 1：输入 API 信息

Step 2：选择要修改的节点

Step 3：修改节点值

3.1 IMAGE 类型

3.2 STRING 类型

3.3 LIST 类型

Step 4：提交任务

Step 5：轮询任务状态

Step 6：获取生成结果

⚡ 小贴士

4. 使用流程总结

5. Python 自动操作脚本完整示例

AI应用完整接入示例

📝 RunningHub AI 应用 Python 交互操作脚本使用手册#

1. 脚本功能概述#

2. 代码介绍#

3. 用户在控制台操作步骤（详细版）#

Step 1：输入 API 信息#

Step 2：选择要修改的节点#

Step 3：修改节点值#

3.1 IMAGE 类型#

3.2 STRING 类型#

3.3 LIST 类型#

Step 4：提交任务#

Step 5：轮询任务状态#

Step 6：获取生成结果#

⚡ 小贴士#

4. 使用流程总结#

5. Python 自动操作脚本完整示例#

📝 RunningHub AI 应用 Python 交互操作脚本使用手册

1. 脚本功能概述

2. 代码介绍

3. 用户在控制台操作步骤（详细版）

Step 1：输入 API 信息

Step 2：选择要修改的节点

Step 3：修改节点值

3.1 IMAGE 类型

3.2 STRING 类型

3.3 LIST 类型

Step 4：提交任务

Step 5：轮询任务状态

Step 6：获取生成结果

⚡ 小贴士

4. 使用流程总结

5. Python 自动操作脚本完整示例