RunningHub 资源上传说明（图片、音视、视频、压缩包）

📌 场景简介

本接口用于资源上传，支持上传图片、音频、视频、ZIP 压缩包（图片压缩包）至 RunningHub 服务器。上传后的文件将被对应加载节点（如 LoadImage，LoadImages(zip)，LoadAudio和LoadVideo ）加载，作为工作流的输入资源使用。

⚠️ 注意事项：

非图床 / 文件存储服务：上传后的图片、音频、视频、压缩包均无法通过 URL 直接访问。

返回的 fileName 字段为文件在服务器上的相对路径，请勿随意拼接为外链访问。

此接口不支持输入url，适用于无外链的场景，有云存储外链时可以直接填入对应的官方节点

📤 上传要求

1. 支持文件类型汇总

文件类别	支持格式
图片	JPG、PNG、JPEG、WEBP
图片压缩包	ZIP
音频	MP3、WAV、FLAC
视频	MP4、AVI、MOV、MKV

2. 单文件大小限制

所有类型文件单文件大小上限为 30MB

✅ 推荐做法：
若文件超过 30MB，请上传到云存储（如 OSS、COS、S3 等），并将文件的 公开直链 URL 传入工作流对应加载节点。
云图像路径支持外链访问，但请确保链接可访问，且稳定可靠。
压缩包文件大小需限制在30MB以内。

🧾 上传响应示例

上传成功后，服务端返回 JSON 响应，fileName 为核心加载路径。

1. 图片上传响应

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

2. 图像（ZIP 压缩包）上传响应

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

3. 音频上传响应

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

4. 视频上传响应

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

🔑 关键字段说明：
fileName为文件加载的唯一路径，需准确传入对应节点。

📥 如何将文件用于对应加载节点？

获取上传返回的 fileName 后，需在工作流配置中按文件类型匹配节点，示例如下：

1. 图片 → `LoadImage` 节点

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

2. 图像（ZIP 压缩包） → `LoadImages(zip)` 节点

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

3. 音频 → `LoadAudio` 节点

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

4. 视频 → `LoadVideo` 节点

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

nodeId：工作流节点的编号
fieldName：字段名，例如图像输入请使用 "image"
fieldValue：上传返回的 fileName 字段值

📝 文件上传后使用流程（以图像压缩包为例）

1. 新建工作流（ZIP批量上传图片）

2.在对应位置填入响应信息

找到指定位置

填写信息

如需进一步支持，请联系技术团队。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

示例

成功示例文件超过10M

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

上传资源（弃用）

RunningHub 资源上传说明（图片、音视、视频、压缩包）

📌 场景简介

📤 上传要求

1. 支持文件类型汇总

2. 单文件大小限制

🧾 上传响应示例

1. 图片上传响应

2. 图像（ZIP 压缩包）上传响应

3. 音频上传响应

4. 视频上传响应

📥 如何将文件用于对应加载节点？

1. 图片 → `LoadImage` 节点

2. 图像（ZIP 压缩包） → `LoadImages(zip)` 节点

3. 音频 → `LoadAudio` 节点

4. 视频 → `LoadVideo` 节点

📝 文件上传后使用流程（以图像压缩包为例）

1. 新建工作流（ZIP批量上传图片）

2.在对应位置填入响应信息

请求参数

请求示例代码

返回响应

上传资源（弃用）

RunningHub 资源上传说明（图片、音视、视频、压缩包）#

📌 场景简介#

📤 上传要求#

1. 支持文件类型汇总#

2. 单文件大小限制#

🧾 上传响应示例#

1. 图片上传响应#

2. 图像（ZIP 压缩包）上传响应#

3. 音频上传响应#

4. 视频上传响应#

📥 如何将文件用于对应加载节点？#

1. 图片 → LoadImage 节点#

2. 图像（ZIP 压缩包） → LoadImages(zip) 节点#

3. 音频 → LoadAudio 节点#

4. 视频 → LoadVideo 节点#

📝 文件上传后使用流程（以图像压缩包为例）#

1. 新建工作流（ZIP批量上传图片）#

2.在对应位置填入响应信息#

请求参数

请求示例代码

返回响应

RunningHub 资源上传说明（图片、音视、视频、压缩包）

📌 场景简介

📤 上传要求

1. 支持文件类型汇总

2. 单文件大小限制

🧾 上传响应示例

1. 图片上传响应

2. 图像（ZIP 压缩包）上传响应

3. 音频上传响应

4. 视频上传响应

📥 如何将文件用于对应加载节点？

1. 图片 → `LoadImage` 节点

2. 图像（ZIP 压缩包） → `LoadImages(zip)` 节点

3. 音频 → `LoadAudio` 节点

4. 视频 → `LoadVideo` 节点

📝 文件上传后使用流程（以图像压缩包为例）

1. 新建工作流（ZIP批量上传图片）

2.在对应位置填入响应信息