Create a Digital Human Avatar
Model ID
Put this value in the request body's `model` field — not the display name above.
by other · Create a digital-human avatar: upload a photo or a video to clone a reusable avatar of your own (asynchronous task), then drive it again and again.
Quick start
POST /v1/videos/avatarshttps://qd.zsopc.com/v1curl https://qd.zsopc.com/v1/videos/avatars \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"name": "我的主播",
"source_url": "https://example.com/portrait.jpg",
"source_kind": "image"
}'
# source_url 必须是公网可访问直链(平台不提供上传端点)
# source_kind: image(默认) / videocurl https://qd.zsopc.com/v1/videos/avatars/$AVATAR_ID \
-H "Authorization: Bearer sk-gpushare-xxxxxxxx"
# 上游通常 5-10 分钟,建议 15-30 秒轮询一次
# ready 后把这个 id 填进 /v1/videos/generations 的 avatar 字段出片This is an async task: submit for a task ID, then poll until it settles. Polling itself is free.
Pricing
Billed per call: a one-off fee to register an avatar, which you can then reuse indefinitely.
- Rates
- per avatar 220.11Credits
- Failed registrations are refunded in full automatically.
- Generating video with this avatar is billed separately at the per-second video rate.
- All your API keys share one balance; when it runs out the API returns HTTP 402 `quota_exceeded`.
Sign in and any personal discount on your account will show up here. Sign in
Capabilities & specs
- Category
- Video generation
- Endpoint family
- Digital avatars (Avatars)
- Released
- 2026-07-24
- License
- Closed source
Try it
Models like this bill for real per image / per second / per call and are mostly async tasks, so there is no one-click test here. Use the sample code above, or generate in the matching workbench (which has a parameter panel and a cost estimate).
Open the workbenchCommon errors
404 model_not_foundYou passed the display name instead of the model ID.✗ Create a Digital Human Avatar→✓ dh-avatar-create
→ Copy the Model ID at the top of this page
402 quota_exceededInsufficient account balance. All your API keys share one balance.
401 / 403The API key is invalid, or it has a model allowlist that doesn't include this ID.
→ Check the key's status and allowed models
400 invalid_request`source_url` is not a publicly reachable direct link, or `name` exceeds 20 characters.
→ Check your request body against the sample code above