上传文件

更新时间：2025-12-24 10:45:20

在发起图片、视频或AI应用生成任务前，需先调用本接口将所需的原始资源文件（如图片、音频、视频等）上传至服务端。成功上传后将返回对应的资源访问路径（fullPath），供后续任务调用时使用。

POST

https://cloud.baicaiinfer.com/v1/resources/upload

Authorizations

Authorizations：StringHeaderRequired

用户需使用已获取的API Key进行身份验证，以访问服务。

Body

application/json

file：fileRequired

要上传的原始文件（图片、视频、音频等）路径。

Response

状态码：

200

application/json

code：IntRequired

表示请求处理状态的状态码。

0

400

500

0是成功标识，表示接口正常返回预期结果。

message：StringRequired

返回请求的处理结果，通常配合状态码使用，直观告知用户当前请求的具体情况。

上传成功

上传失败

成功标识，表示请求完全正常处理，无任何问题。

data：objectRequired

任务的核心结果数据，包含任务详情信息。

data.id：StringRequired

任务的唯一标识。

data.message：StringRequired

文件上传操作的结果描述。

data.filename：StringRequired

文件上传后，在系统中对应的存储文件名。

data.filePath：StringRequired

上传文件生成的唯一访问地址，后续任务可通过此URL引用该资源。

data.type：StringRequired

标识该上传文件的类型/用途。

data.path：StringRequired

文件上传后的绝对路径。

ts：StringRequired

响应的时间戳。

cURL

Python

JavaScript

curl --location --request POST 'https://cloud.baicaiinfer.com/v1/resources/upload' \
--header 'Authorization: Bearer sk-uP3Lw6MX3pzAu2V49sB*****' \
--form 'file=@"/workspace/73.png"'

200

400

401

404

500

{
    "code": 0,
    "message": "上传成功",
    "data": {
        "id": "7e4113a5a1284465831eaefaa0022a98",
        "message": "文件上传成功",
        "filename": "7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg",
        "fullPath": "https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg",
        "type": "file",
        "path": "/root/ComfyUI/input/7e4113a5a1284465831eaefaa0022a98/fmJHcc-travel_memories.jpg"
    },
    "ts": "2025-12-23T10:10:26.689242298+08:00[Asia/Shanghai]"
}