O

Create a Digital Human Avatar

NEW

Model ID

Put this value in the request body's `model` field — not the display name above.

Video generationClosed source

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.

Try it now

Quick start

EndpointPOST /v1/videos/avatars
AuthenticationAuthorization: Bearer sk-gpushare-…Get API key
Call styleAsynchronous: submit for an ID, then poll until it settles
Base URLhttps://qd.zsopc.com/v1
① Register the avatar · cURL
curl 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(默认) / video
② Poll until ready, then generate video · cURL
curl 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 workbench

Common errors

404 model_not_found

You 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_exceeded

Insufficient account balance. All your API keys share one balance.

→ Add funds in your account

401 / 403

The 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

Try it

Create a Digital Human Avatar FAQ

How do I call Create a Digital Human Avatar?
Set the model field of the request body to dh-avatar-create, send it to https://qd.zsopc.com/v1/avatars, and put your key (it starts with sk-gpushare-) in the Authorization: Bearer header. This is not a chat SKU; submit tasks to the dedicated endpoint above.
How much does the Create a Digital Human Avatar API cost?
  • Per digital-human avatar: 220.11 credits (≈ ¥3.67 / ≈ $0.544)
  • Prices are in credits: 60 credits = ¥1. Each call first holds the most it could cost, then settles on actual usage and refunds the difference.

Prices and details updated 2026-11-17. Markdown version of this page: /en/models/dh-avatar-create.md