Upload Asset

POST

/v1/assets/upload

This asset endpoint supports the following models:
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

Submit asset URLs to the asset library and receive asset IDs. Supports either a single URL or a batch of multiple URLs.
URL requirements:

Must be a publicly accessible http(s) URL; localhost, private/loopback IPs, and local files are not supported.

The file extension must be within the supported set (and must match type):

Image: jpeg / jpg / png / webp / bmp / tiff / gif / heic

Video: mp4 / mov

Audio: wav / mp3

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Request Example (Single)Request Example (Multiple)

{
    "url": "https://cdn.example.com/portrait.jpg",
    "type": "image",
    "purpose": "Digital human appearance"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Request Example (Single)Request Example (Multiple)

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": "Digital human appearance"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

Response Example (Single)Response Example (Batch)Moderation Rejected

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

Modified at 2026-09-10 05:59:18

Asset Library API Integration Guide (Volcengine Official Format)

List Assets