RunningHub Resource Upload Guide (Images, Audio, Video, Compressed Files)

📌 Scenario Overview

This API is used for resource uploads, supporting the upload of images, audio, video, and ZIP compressed packages (image compressed packages) to the RunningHub server. Uploaded files will be loaded by corresponding loading nodes (e.g., LoadImage, LoadImages(zip), LoadAudio, and LoadVideo) and used as input resources for workflows.

⚠️ Important Notes:

Not an image hosting/file storage service: Uploaded images, audio, video, and compressed packages cannot be directly accessed via URL.

The returned fileName field is the relative path of the file in the server. Do not randomly concatenate it into external links for access.

📤 Upload Requirements

1. Supported File Types Summary

File Category	Supported Formats
Images	JPG, PNG, JPEG, WEBP
Image Compressed Packages	ZIP
Audio	MP3, WAV, FLAC
Video	MP4, AVI, MOV, MKV

2. Single File Size Limit

The maximum size of a single file for all types is 30MB.

✅ Recommended Practices
If a file exceeds 30MB, please upload it to cloud storage (e.g., OSS, COS, S3, etc.) and pass the file's public direct-link URL to the corresponding loading node in the workflow.
The cloud storage path must support external link access. Ensure the link is accessible and stable.
The size of compressed files must be limited to within 30MB.

🧾 Upload Response Examples

After a successful upload, the server will return a JSON response, where fileName is the core path for file loading.

1. Image Upload Response

{
  "code": 0,
  "msg": "success",
  "data": {
    "fileName": "api/9d77b8530f8b3591edc5c4e8f3f55b2cf0960bb2ca35c04e32c1677687866576.png",
    "fileType": "input"
  }
}

2. Image (ZIP Compressed Package) Upload Response

{
    "code": 0,
    "msg": "success",
    "data": {
        "fileName": "6c8e54223d1a46185917429fbb0be83e6d5063e6016d0673ebad5da35753ecd0",
        "fileType": "input"
    }
}

3. Audio Upload Response

{
  "code": 0,
  "msg": "success",
  "data": {
    "fileName": "api/7a2f4c8d1e5b9g3h6j0k2l7m4n8p1q3r5s9t0u2v4w6x8y0z1.mp3",
    "fileType": "input"
  }

4. Video Upload Response

{
    "code": 0,
    "msg": "success",
    "data": {
        "fileName": "api/14c585a56d8f7c3b9c1ad3c4f8edc93a9fd9f79e21b4d10afd811322bf65f3c2.mp4",
        "fileType": "input"
    }
}

🔑 Key Field Description:

fileName is the unique path for file loading and must be accurately passed to the corresponding node.

📥 How to Use Files in Corresponding Loading Nodes

After obtaining the fileName returned from the upload, configure it in the workflow according to the file type and matching node, as shown in the examples below:

1. Image → `LoadImage` Node

"nodeInfoList": [
  {
    "nodeId": "10",
    "fieldName": "image",
    "fieldValue": "api/9d77b8530f8b3591edc5c4e8f3f55b2cf0960bb2ca35c04e32c1677687866576.png"
  }
]

2. Image (ZIP Compressed Package) → `LoadImages(zip)` Node

"nodeInfoList": [
  {
    "nodeId": "6",
    "fieldName": "upload",
    "fieldValue": "6c8e54223d1a46185917429fbb0be83e6d5063e6016d0673ebad5da35753ecd0"
  }
]

3. Audio → `LoadAudio` Node

"nodeInfoList": [
  {
    "nodeId": "2",
    "fieldName": "audio",
    "fieldValue": "api/7a2f4c8d1e5b9g3h6j0k2l7m4n8p1q3r5s9t0u2v4w6x8y0z1.mp3"
  }
]

4. Video → `LoadVideo` Node

"nodeInfoList": [
  {
    "nodeId": "7",
    "fieldName": "video",
    "fieldValue": "api/14c585a56d8f7c3b9c1ad3c4f8edc93a9fd9f79e21b4d10afd811322bf65f3c2.mp4"
  }
]

nodeId: The ID of the workflow node
fieldName: The field name (e.g., use "image" for image input)
fieldValue: The value of the fileName field returned from the upload

📝 Post-Upload File Usage Process (Taking Image Compressed Packages as an Example)

1. Create a New Workflow (ZIP Batch Image Upload)

2. Fill in the Response Information in the Corresponding Position

Find the specified location

Fill in the information

If further support is needed, please contact the technical team.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

Examples

SuccessFile exceeds 10MB

{
    "code": 0,
    "msg": "success",
    "data": {
        "fileName": "api/9d77b8530f8b3591edc5c4e8f3f55b2cf0960bb2ca35c04e32c1677687866576.png",
        "fileType": "input"
    }
}

Upload Resource(image\video\audio\Compressed Files)

RunningHub Resource Upload Guide (Images, Audio, Video, Compressed Files)

📌 Scenario Overview

📤 Upload Requirements

1. Supported File Types Summary

2. Single File Size Limit

🧾 Upload Response Examples

1. Image Upload Response

2. Image (ZIP Compressed Package) Upload Response

3. Audio Upload Response

4. Video Upload Response

📥 How to Use Files in Corresponding Loading Nodes

1. Image → `LoadImage` Node

2. Image (ZIP Compressed Package) → `LoadImages(zip)` Node

3. Audio → `LoadAudio` Node

4. Video → `LoadVideo` Node

📝 Post-Upload File Usage Process (Taking Image Compressed Packages as an Example)

1. Create a New Workflow (ZIP Batch Image Upload)

2. Fill in the Response Information in the Corresponding Position

Request

Request Code Samples

Responses

Upload Resource(image\video\audio\Compressed Files)

RunningHub Resource Upload Guide (Images, Audio, Video, Compressed Files)#

📌 Scenario Overview#

📤 Upload Requirements#

1. Supported File Types Summary#

2. Single File Size Limit#

🧾 Upload Response Examples#

1. Image Upload Response#

2. Image (ZIP Compressed Package) Upload Response#

3. Audio Upload Response#

4. Video Upload Response#

📥 How to Use Files in Corresponding Loading Nodes#

1. Image → LoadImage Node#

2. Image (ZIP Compressed Package) → LoadImages(zip) Node#

3. Audio → LoadAudio Node#

4. Video → LoadVideo Node#

📝 Post-Upload File Usage Process (Taking Image Compressed Packages as an Example)#

1. Create a New Workflow (ZIP Batch Image Upload)​#

2. Fill in the Response Information in the Corresponding Position#

Request

Request Code Samples

Responses

RunningHub Resource Upload Guide (Images, Audio, Video, Compressed Files)

📌 Scenario Overview

📤 Upload Requirements

1. Supported File Types Summary

2. Single File Size Limit

🧾 Upload Response Examples

1. Image Upload Response

2. Image (ZIP Compressed Package) Upload Response

3. Audio Upload Response

4. Video Upload Response

📥 How to Use Files in Corresponding Loading Nodes

1. Image → `LoadImage` Node

2. Image (ZIP Compressed Package) → `LoadImages(zip)` Node

3. Audio → `LoadAudio` Node

4. Video → `LoadVideo` Node

📝 Post-Upload File Usage Process (Taking Image Compressed Packages as an Example)

1. Create a New Workflow (ZIP Batch Image Upload)

2. Fill in the Response Information in the Corresponding Position