📝 RunningHub AI Workflow Interactive Manual (workflow version)

1. Overview

This script uses RunningHub AI Platform OpenAPI to automatically perform the entire workflow: load local workflow JSON, modify node information, upload files, submit tasks, and query results.

Main features:

Read local workflow configuration (JSON file)

Generate a modifiable node information list (nodeInfoList)

Modify node values based on type (image, text, etc.)

Upload image, audio, or video files

Submit tasks to RunningHub and monitor status in real-time

Output generated result file URLs

✅ Suitable for advanced users with custom workflow (workflowId) who want to run AI workflows without opening the web page.

2. Files and Main Functions

💡 Main Files

File Name	Function
workflow.py	Main execution script
api.json	Workflow configuration downloaded from RunningHub (contains node definitions)

🔧 Core Functions

Function Name	Description
load_json(file_path)	Load and parse workflow JSON from local file
convert_to_node_info_list(data)	Convert JSON format to a list of node information
upload_file(API_KEY, file_path)	Upload local file (image/audio/video) to RunningHub
submit_task(workflowId, node_info_list, API_KEY)	Submit task to start AI workflow execution
query_task_outputs(task_id, API_KEY)	Poll task status and get result outputs

3. Detailed Steps

Step 1️⃣: Input Required Information

Run the script, then enter:

Please enter your api_key:

Explanation: get it from the "API Call" section in RunningHub console.
Example: 0s2d1***********2n3mk4

Please enter workflowId:

Example: 1980468315921559554
(from URL: https://www.runninghub.cn/workflow/1980237776367083521?source=workspace)

Then enter the local workflow JSON file path:

Enter your JSON file address (the JSON file must be obtained in your own workbench by exporting the workflow API to your local computer):

Example: C:\Users\Mayn\Downloads\api.json

The script will output all nodes in the workflow:

Waiting for node_info_list generation (contains all modifiable nodes)
{'3': {'inputs': {...}}, '4': {...}, '6': {...}, ...}

Step 2️⃣: View and Modify Nodes

Script will prompt:

Please enter nodeId (enter 'exit' to finish modifying):

Enter a nodeId (e.g., 10) to see all fields:

🧩 Found node 10 fields:
(0, {'nodeId': '10', 'fieldName': 'image', 'fieldValue': 'xxx.jpg'})

Then enter the field name you want to modify:

Please enter the fieldName to modify:

Example: image

Step 3️⃣: Modify Field Values

📷 For file type (image/audio/video)

Please enter your local image file path:

Example: D:\R.jpg

Upload success:

Uploading file, please wait
Upload result: {'code': 0, 'msg': 'success', 'data': {'fileName': 'api/xxx.jpg', 'fileType': 'input'}}
✅ Updated image fieldValue: api/xxx.jpg

📝 For text or numeric type

Please enter new fieldValue (text):

Example: 1 girl in classroom

Result:

✅ Updated fieldValue: 1 girl in classroom

You can modify multiple nodes; enter exit to finish.

Step 4️⃣: Submit Task

After modification, script submits task automatically:

Submitting task, please wait
📌 Task submission result: {'code': 0, 'msg': 'success', 'data': {...}}
📝 taskId: 1980471280073846785
✅ No node errors, task submitted successfully.

Step 5️⃣: Poll Task Status

The script checks status every 5 seconds:

⏳ Task running...
⏳ Task running...
🎉 Generation complete!

If task fails, detailed reason is printed:

❌ Task failed!
Node SaveImage error: 'str' object has no attribute 'shape'
Traceback: [...]

Step 6️⃣: View Result Files

If successful, output file URLs:

🎉 Generation complete!
[{'fileUrl': 'https://rh-images.xiaoyaoyou.com/f24a6365b08fa3bc02f55cd1f63e74a7/output/ComfyUI_00001_hnqxe_1761016156.png',
  'fileType': 'png',
  'taskCostTime': '35',
  'nodeId': '17'}]
✅ Task complete!

Open fileUrl to view AI-generated images.

4. Complete Workflow Overview

1️⃣ Enter API_KEY and workflowId
2️⃣ Load local JSON workflow
3️⃣ Auto-generate modifiable node list
4️⃣ Modify required node parameters
5️⃣ Upload files (e.g., images)
6️⃣ Submit task to RunningHub
7️⃣ Poll task status
8️⃣ Retrieve and print result URLs

5. Example Output

Please enter your api_key: a0fada**************b2ke21
Please enter workflowId: ***8315921559***
Enter your JSON file address (the JSON file must be obtained in your own workbench by exporting the workflow API to your local computer): C:\Users\Mayn\Downloads\api.json

🧩 Found node 10 fields:
(0, {'nodeId': '10', 'fieldName': 'image', 'fieldValue': 'xxx.jpg'})
✅ Updated image fieldValue: api/xxx.jpg

Submitting task, please wait
📌 Task submission result: {...}
⏳ Task running...
🎉 Generation complete!
✅ Task complete!

6. Tips

Use Python 3.8+

Run directly in terminal:

Windows users: use double backslashes \ in file paths

If using a proxy or cloud server, ensure port 443 can access www.runninghub.cn

Full Workflow Integration Example

📝 RunningHub AI Workflow Interactive Manual (workflow version)#

1. Overview#

2. Files and Main Functions#

💡 Main Files#

🔧 Core Functions#

3. Detailed Steps#

Step 1️⃣: Input Required Information#

Step 2️⃣: View and Modify Nodes#

Step 3️⃣: Modify Field Values#

📷 For file type (image/audio/video)#

📝 For text or numeric type#

Step 4️⃣: Submit Task#

Step 5️⃣: Poll Task Status#

Step 6️⃣: View Result Files#

4. Complete Workflow Overview#

5. Example Output#

6. Tips#