上传素材

POST

/v1/assets/upload

该素材文档支持模型如下：
doubao-seedance-2-0-260128
doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-mini-260615
doubao-seedance-2-5-260628
dreamina-seedance-2-0-hc
dreamina-seedance-2-0-fast-hc
dreamina-seedance-2-0-mini-hc
dreamina-seedance-2-5-hc

把素材 URL 提交到素材库，返回素材 ID。支持单个 URL 或一次批量多个 URL。
URL 要求

必须是公网可访问的 http(s) 地址，不支持 localhost、内网/回环 IP、本地文件。

扩展名须在支持范围内（须与 type 匹配）：

图片：jpeg / jpg / png / webp / bmp / tiff / gif / heic

视频：mp4 / mov

音频：wav / mp3

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

请求示例（单个）请求示例（多个）

{
    "url": "https://cdn.example.com/portrait.jpg",
    "type": "image",
    "purpose": "数字人形象"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

请求示例（单个）请求示例（多个）

curl --location 'https://www.aiide.com/v1/assets/upload' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "https://cdn.example.com/portrait.jpg",
    "type": "image",
    "purpose": "数字人形象"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

响应示例（单个）响应示例（批量）审核不通过

{
    "data": {
        "asset_id": "mat_ADyx4iQvkHUy7jDzPKqp",
        "group_id": "ak-*******",
        "status": "ready"
    },
    "message": "",
    "success": true
}

修改于 2026-08-11 02:37:36

真人素材库接口描述-doubao/dreamina-hc

查询素材列表