📝 RunningHub AI Application Python Interactive Script User Manual

1. Script Function Overview

This Python script allows you to:

Retrieve editable node information (nodeInfoList) of a specified AI application (WebApp).

Modify node values according to their type (image, text, etc.).

Upload local files to the AI application.

Submit the modified task to the AI application.

Automatically poll the task status until the result is generated.

Output the generated result file link.

In short: You can use this script to send local files or text to RunningHub AI applications for generation or processing, and automatically retrieve the results.

2. Code Introduction

`def get_nodo(webappId, Api_Key)`

Retrieves the node list (nodeInfoList) of the AI application. Refer to RunningHub official API documentation for “Get AI Application Information Example”.

`def upload_file(API_KEY, file_path)`

Uploads a local file to the RunningHub server (image). Refer to official API documentation for “Upload Resource Example”.

`def submit_task(webapp_id, node_info_list, API_KEY)`

Submits an AI application task. Refer to official API documentation for “Submit Task Example”.

`def query_task_outputs(task_id, API_KEY)`

Queries task status (the /task/openapi/status endpoint is no longer maintained) and retrieves the generated result. Refer to official API documentation for “Query Task Output Example”.

`main` function

Allows users to interact with the script in the console, completing the full process:
Retrieve node list → Modify node info → Submit task → Poll task status → Retrieve task result.

3. User Console Operation Steps (Detailed)

Step 1: Input API Information

The script first prompts you to enter the API Key and WebApp ID to retrieve the AI application’s node information.

Please enter your api_key:

Example: a0fa3e****************345171

Please enter webappId:

Example: 1937084629516193794

Note: The WebApp link is https://www.runninghub.cn/ai-detail/1937084629516193794. The number at the end is the webappId.

The script retrieves nodeInfoList, which contains all editable nodes:

[
  {
    "nodeId": "39",
    "nodeName": "LoadImage",
    "fieldName": "image",
    "fieldValue": "a293d89506f9c484f4ea5695f93024a80cd62ef98f4ee4543faba357536b37ec.jpg",
    "fieldType": "IMAGE",
    "description": "Upload Image"
  },
  {
    "nodeId": "37",
    "nodeName": "RH_ComfyFluxKontext",
    "fieldName": "model",
    "fieldValue": "flux-kontext-pro",
    "fieldType": "LIST",
    "description": "Model Selection"
  },
  {
    "nodeId": "37",
    "nodeName": "RH_ComfyFluxKontext",
    "fieldName": "aspect_ratio",
    "fieldValue": "match_input_image",
    "fieldType": "LIST",
    "description": "Output Ratio"
  },
  {
    "nodeId": "52",
    "nodeName": "RH_Translator",
    "fieldName": "prompt",
    "fieldValue": "Change this woman's hairstyle to short bob,",
    "fieldType": "STRING",
    "description": "Image Editing Text Input"
  }
]

Step 2: Select Node to Modify

After generating nodeInfoList, the script prompts you to input the node ID and field name for modification.

Please enter nodeId (type 'exit' to finish modifications):

Example input: 39

Please enter fieldName:

Example input: image

The script displays the selected node information:

Selected node: {'nodeId': '39', 'nodeName': 'LoadImage', 'fieldName': 'image', 'fieldValue': 'a293d8...', 'fieldType': 'IMAGE', 'description': 'Upload Image'}

Step 3: Modify Node Value

3.1 IMAGE Type

Prompt:

Please enter your local IMAGE file path:

Example input: D:\R.jpg

After successful upload, the script returns the file information and automatically updates the node value:

Uploading file...
Upload result: {'code': 0, 'msg': 'success', 'data': {'fileName': 'api/xxxx.jpg', 'fileType': 'image'}}
✅ IMAGE fieldValue updated: api/xxxx.jpg

3.2 STRING Type

Prompt:

Please enter new fieldValue (STRING):

Example input: Change this man's hairstyle to short bob

Return:

✅ fieldValue updated: Change this man's hairstyle to short bob

3.3 LIST Type

Prompt:

Please enter new fieldValue (LIST):

Example: Select one value from the list in fieldData to update fieldValue.

Return:

✅ fieldValue updated: 1:1

You can loop to modify multiple nodes until you type exit.

Step 4: Submit Task

After modifying nodes, the script automatically submits the task:

Submitting task, please wait...
📌 Submit task response: {'code': 0, 'msg': 'success', 'data': {'taskId': '1979110509284917250', ... ,'promptTips': '{"result": true, "error": null, "outputs_to_execute": ["36"], "node_errors": {}}'}}}

If node_errors in promptTips is not empty, it indicates a node error.

⚠️ Node error information:
node_errors{}
📝 taskId: 1979110509284917250

Note: taskId is used to query task status and retrieve results.
Note:If node_errors in promptTips is not empty, it indicates that there are errors in some nodes.

Step 5: Poll Task Status

The script automatically polls every 5 seconds:

⏳ Task in queue...
⏳ Task running...
🎉 Generation completed!
✅ Task completed!

SUCCESS → Task completed

failedReason → Task failed

Other statuses → Waiting

Step 6: Retrieve Generated Result

After the task completes, the script outputs the result link:

🎉 Generation completed!
https://rh-images.xiaoyaoyou.com/f24a6365b08fa3bc02f55cd1f63e74a7/output/ComfyUI_00001_vpvtp_1760691733.png

Open the link directly to view the generated file.

⚡ Tips

File path format:

Windows: D:\path\to\file.jpg

Network issues:

Upload or task submission may fail due to slow network; retry if needed.

Modify multiple nodes at once:

Loop input nodeId + fieldName + new value, type exit to finish.

File type handling:

IMAGE → Auto upload file

STRING → Enter text directly

LIST → Select one index value from fieldData to update fieldValue

4. Usage Flow Summary

Input api_key and webappId

Retrieve nodeInfoList

Loop modify nodes

Submit task

Auto poll status

Retrieve generated file link

Fully automate RunningHub AI application operations via Python script, without manually operating on the web — ideal for batch tasks.

Complete integration example

📝 RunningHub AI Application Python Interactive Script User Manual

1. Script Function Overview

2. Code Introduction

`def get_nodo(webappId, Api_Key)`

`def upload_file(API_KEY, file_path)`

`def submit_task(webapp_id, node_info_list, API_KEY)`

`def query_task_outputs(task_id, API_KEY)`

`main` function

3. User Console Operation Steps (Detailed)

Step 1: Input API Information

Step 2: Select Node to Modify

Step 3: Modify Node Value

3.1 IMAGE Type

3.2 STRING Type

3.3 LIST Type

Step 4: Submit Task

Step 5: Poll Task Status

Step 6: Retrieve Generated Result

⚡ Tips

4. Usage Flow Summary

5. Complete Python Automation Script Example

Complete integration example

📝 RunningHub AI Application Python Interactive Script User Manual#

1. Script Function Overview#

2. Code Introduction#

def get_nodo(webappId, Api_Key)#

def upload_file(API_KEY, file_path)#

def submit_task(webapp_id, node_info_list, API_KEY)#

def query_task_outputs(task_id, API_KEY)#

main function#

3. User Console Operation Steps (Detailed)#

Step 1: Input API Information#

Step 2: Select Node to Modify#

Step 3: Modify Node Value#

3.1 IMAGE Type#

3.2 STRING Type#

3.3 LIST Type#

Step 4: Submit Task#

Step 5: Poll Task Status#

Step 6: Retrieve Generated Result#

⚡ Tips#

4. Usage Flow Summary#

5. Complete Python Automation Script Example#

📝 RunningHub AI Application Python Interactive Script User Manual

1. Script Function Overview

2. Code Introduction

`def get_nodo(webappId, Api_Key)`

`def upload_file(API_KEY, file_path)`

`def submit_task(webapp_id, node_info_list, API_KEY)`

`def query_task_outputs(task_id, API_KEY)`

`main` function

3. User Console Operation Steps (Detailed)

Step 1: Input API Information

Step 2: Select Node to Modify

Step 3: Modify Node Value

3.1 IMAGE Type

3.2 STRING Type

3.3 LIST Type

Step 4: Submit Task

Step 5: Poll Task Status

Step 6: Retrieve Generated Result

⚡ Tips

4. Usage Flow Summary

5. Complete Python Automation Script Example