资源文件上传说明

📌 场景简介

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

响应结果中：

download_url 用于标准模型 API

fileName 用于 comfyUI 节点

⚠️ 注意事项：

非图床 / 文件存储服务：上传后的获得的链接具有一天有效期，超期将无法通过 URL 直接访问。

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

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

📤 上传要求

1. 支持文件类型汇总

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

🔑 关键字段说明：
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

返回响应

🟢200成功

application/json

Body

示例

成功示例异常示例

{
    "code": 0,
    "message": "success",
    "data": {
        "type": "image",
        "download_url": "https://rh-images-switch-1252422369.cos.ap-guangzhou.myqcloud.com/input/openapi/61432ac1b3f3f5b19edcccff137d49d24a907b32ef3a737d1958e33aa91f1f44.png?q-sign-algorithm=sha1&q-ak=AKIDv56FISEJUsKsMeELk0gmbNCGKTYSaZ3N&q-sign-time=1767852886%3B1767939286&q-key-time=1767852886%3B1767939286&q-header-list=host&q-url-param-list=&q-signature=b9775a887dbdf7889e9af7ab5812455cb2d74660",
        "fileName": "openapi/61432ac1b3f3f5b19edcccff137d49d24a907b32ef3a737d1958e33aa91f1f44.png",
        "size": "3490"
    }
}

文件上传

资源文件上传说明#

📌 场景简介#

📤 上传要求#

1. 支持文件类型汇总#

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

1. 图片 → LoadImage 节点#

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

3. 音频 → LoadAudio 节点#

4. 视频 → LoadVideo 节点#

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

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

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

请求参数