curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "brand-avatar-group",
"description": "Virtual avatar asset group"
}'
{
"success": true,
"message": "",
"data": {
"asset_id": "asset-20260318071009-*****",
"group_id": "group-20260318033332-*****",
"asset_type": "image",
"source_url": "https://ark-media-asset.example.com/xxx",
"status": "active",
}
}
seedance-2
Seedance 2 Private Avatar Assets
Create a private virtual avatar group, upload assets, and poll asset status
POST
/
v1
/
videos
/
doubao-seedance-2-0
/
private-avatar
/
groups
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "brand-avatar-group",
"description": "Virtual avatar asset group"
}'
{
"success": true,
"message": "",
"data": {
"asset_id": "asset-20260318071009-*****",
"group_id": "group-20260318033332-*****",
"asset_type": "image",
"source_url": "https://ark-media-asset.example.com/xxx",
"status": "active",
}
}
Note for users in mainland China: Please use
https://toapis.cn as the API endpoint (Base URL). Replace https://toapis.com with https://toapis.cn in the examples in this document.- Exposes only the minimum user-facing workflow
- Asset ingestion accepts public
source_urlonly - Only assets with
status=activecan be used for generation
This legacy API remains available. To review media within a video task, see on-demand asset review and set
private_asset_review: true. Omit the switch or set it to false when using existing asset:// references; new mode rejects them.Authorizations
string
required
All requests require Bearer Token authentication.
Workflow
1. Create Asset Group
Call this endpoint:POST /v1/videos/doubao-seedance-2-0/private-avatar/groups
- Creates a new virtual avatar asset group
- Returns the
group_idused in the upload step
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "brand-avatar-group",
"description": "Virtual avatar asset group"
}'
2. Upload Asset
Call this endpoint:POST /v1/videos/doubao-seedance-2-0/private-avatar/assets
- Uploads one asset into the target group
- Returns an
asset_id - Starts asynchronous processing
asset_type values:
imagevideoaudio
source_url must be a publicly reachable http/https URL.
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/private-avatar/assets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"group_id": "group-20260318033332-*****",
"asset_type": "image",
"source_url": "https://files.example.com/avatar-full-body.jpg",
"name": "full-body"
}'
3. Get Asset Status
Call this endpoint:GET /v1/videos/doubao-seedance-2-0/private-avatar/assets/{asset_id}
- Returns the current asset status
- Tells you whether the asset is ready for video generation
status=active.
{
"success": true,
"message": "",
"data": {
"asset_id": "asset-20260318071009-*****",
"group_id": "group-20260318033332-*****",
"asset_type": "image",
"source_url": "https://ark-media-asset.example.com/xxx",
"status": "active",
}
}
Use In Video Generation
Call this endpoint:POST /v1/videos/generations
active, use asset://<ASSET_ID> in your generation request.
Once the asset becomes active, reference it with:
{
"image_with_roles": [
{
"url": "asset://asset-20260318071009-*****",
"role": "reference_image"
}
]
}