Upload Lora

⚠️ Important Notice

The Lora file uploaded through this API is different from those uploaded via the platform interface.
It can only be used with the RHLoraLoader node — other nodes cannot use it.

📌 Key Points

Caching is based on the md5Hex value of the file.

Make sure to calculate the correct MD5 hash before uploading to avoid mismatches.

📥 Response Example

After requesting the upload URL, you'll receive a response like:

{
  "code": 0,
  "msg": "success",
  "data": {
    "fileName": "api-lora-cn/f8d958506e6c8044f79ccd7c814c6179.safetensors",
    "url": "https://rh-models-1252422369.cos.ap-beijing.myqcloud.com/api-lora-cn/f8d958506e6c8044f79ccd7c814c6179.safetensors?..."
  }
}

⬆️ Upload the Lora File

Once you have the url, upload the file using curl (or another tool):

Replace @D:\temp\my-lora-name.safetensors with the path to your actual Lora file.

✅ Ready to Use

No syncing delay — once the file is uploaded, you can use it immediately
by setting the fileName (e.g. api-lora-cn/f8d958506e6c8044f79ccd7c814c6179.safetensors)
as the input in the RHLoraLoader node.

Request

Authorization

Header Params

Host

string

optional

Example:

www.runninghub.ai

Body Params application/json

apiKey

string

required

apiKey, cannot be blank

Example:

loraName

string

required

lora name, cannot be blank

Example:

my-lora-name

md5Hex

string

required

file MD5, cannot be blank

Example:

f8d958506e6c8044f79ccd7c814c6179

Example

{
    "apiKey": "{{apiKey}}",
    "loraName": "my-lora-name",
    "md5Hex": "f8d958506e6c8044f79ccd7c814c6179"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Body

code

integer

optional

返回标记：成功标记=0，非0失败，或者是功能码

msg

string

optional

返回信息

data

null

optional

数据

Example

{
    "code": 0,
    "msg": "success",
    "data": {
        "fileName": "api-lora-cn/f8d958506e6c8044f79ccd7c814c6179.safetensors",
        "url": "https://rh-models-1252422369.cos.ap-beijing.myqcloud.com/api-lora-cn/f8d958506e6c8044f79ccd7c814c6179.safetensors?q-sign-algorithm=sha1&q-ak=AKIDv56FISEJUsKsMeELk0gmbNCGKTYSaZ3N&q-sign-time=1742889838%3B1742893438&q-key-time=1742889838%3B1742893438&q-header-list=host&q-url-param-list=&q-signature=72361dbd6e4eb58ba32fb575400f942f097e47ea"
    }
}

⚠️ Important Notice#

📌 Key Points#

📥 Response Example#

⬆️ Upload the Lora File#

✅ Ready to Use#

Request

Request samples

Responses

⚠️ Important Notice

📌 Key Points

📥 Response Example

⬆️ Upload the Lora File

✅ Ready to Use