curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "https://your-app.example.com/doubao/callback",
"locale": "zh",
"biz_id": "user-123"
}'
seedance-2
Seedance 2 Real Avatar Assets
Create a real-person verification task, fetch the verification result, and upload real avatar assets
POST
/
v1
/
videos
/
doubao-seedance-2-0
/
real-avatar
/
verify-tasks
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "https://your-app.example.com/doubao/callback",
"locale": "zh",
"biz_id": "user-123"
}'
중국 본토 사용자 안내: 중국 본토 사용자는
https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.verify-tasks.completedmeans the verification session was created, not that the user has passed verification- The returned H5 link expires after
120seconds
Authorizations
string
필수
All requests require Bearer Token authentication.
Workflow
1. Create Verification Task
Call this endpoint:POST /v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks
- Creates a new real-person verification task
- Returns a
task_id - You will use that
task_idto fetch verification details
curl --request POST \
--url https://toapis.com/v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"callback_url": "https://your-app.example.com/doubao/callback",
"locale": "zh",
"biz_id": "user-123"
}'
2. Get Verification Task Details
Call this endpoint:GET /v1/videos/doubao-seedance-2-0/real-avatar/verify-tasks/{task_id}
- Returns the verification task details
- Gives you the
h5_linkfor the end user - Gives you the
byted_tokenused in the next step
h5_link, byted_token, and expires_at.
3. Get Verification Result
Call this endpoint:GET /v1/videos/doubao-seedance-2-0/real-avatar/verify-results
task_idbyted_tokenresult_codeis recommended
- Confirms whether verification has passed
- Returns the
group_idrequired for asset upload
resultCode and bytedToken from your callback URL.
Recommended query:
curl --request GET \
--url 'https://toapis.com/v1/videos/doubao-seedance-2-0/real-avatar/verify-results?task_id=tsk_dav_01K...&result_code=10000' \
--header 'Authorization: Bearer <token>'
verify_status=verifiedgroup_idis present
4. Upload Real Avatar Asset
Call this endpoint:POST /v1/videos/doubao-seedance-2-0/real-avatar/assets
- Uploads one real-avatar asset into the verified group
- Returns an
asset_id - Starts asynchronous processing
group_id must come from a verified real-avatar task owned by the current user.
It cannot be manually fabricated or reused across users.
5. Get Asset 상태
Call this endpoint:GET /v1/videos/doubao-seedance-2-0/real-avatar/assets/{asset_id}
- Returns the current asset status
- Tells you whether the asset is ready for video generation
GET /real-avatar/assets/{asset_id} until status=active.
Use In 비디오 생성
Call this endpoint:POST /v1/videos/generations
{
"image_with_roles": [
{
"url": "asset://asset-20260318071009-*****",
"role": "reference_image"
}
]
}