上传素材

POST

/api/assets/upload

注意：传入图像、音频、视频素材时，仅支持通过 URL 传入素材，不支持 base64。

图像（Image）
项目要求
支持格式 jpeg、png、webp、bmp、tiff、gif、heic / heif
宽高比（宽/高） 0.4 ~ 2.5
分辨率（宽或高） 300 ~ 6000 px
单张大小小于 30MB

视频（Video）
项目要求
支持格式 mp4、mov
分辨率 480p / 720p
时长 2 ~ 15 秒
宽高比（宽/高） 0.4 ~ 2.5
分辨率范围（宽或高） 300 ~ 6000 px
总像素范围 409,600 ~ 927,408 px（示例：640 × 640 = 409,600 | 834 × 1112 = 927,408）
文件大小 ≤ 50MB
帧率（FPS） 24 ~ 60

音频（Audio）
项目要求
支持格式 wav、mp3
时长 2 ~ 15 秒
文件大小 ≤ 15MB

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
    "asset_type": "Image",
    "name": "adc111222"
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.easyart.cc/api/assets/upload' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg",
    "asset_type": "Image",
    "name": "adc111222"
  }'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "Id": "asset-20260512112946-mf8xl"
    }
}

修改于 2026-05-13 09:58:57

获取任务图片的seed

根据id获取单个素材