Image Upload

Passing in an image as a character with this method can greatly reduce the time required to create a character. The image will be automatically deleted after 90 days.

API Overview

Method	HTTP Request	Description
Create	POST /live/v1/avatars	Create character asset
Get	GET /live/v1/avatars/{id}	Retrieve a single character asset
Delete	DELETE /live/v1/avatars/{id}	Delete character asset
List	GET /live/v1/avatars	Paginated list query

2. Create Character Asset Request Example

curl -X POST "https://api.vidu.cn/live/v1/avatars" \
  -H "Authorization: Token vda_xxx" \
  -H "Content-Type: application/json" \
  -d '{"image_uri": "https://example.com/avatar.png", "name": "My Character"}'

Request Parameters

image_uristring

The image of the character. Supports public URLs and base64. Only 1 image (single person) is supported; full-body / half-body and various styles are supported. Format: PNG / JPG / JPEG / WEBP; image size ≤ 50MB; byte length after base64 decode < 20M, and a content type prefix must be included, for example data:image/png;base64,{base64_encode}

namestringOptional

Optional display name; empty if not provided

Response Parameters

idstring

Character asset ID (can be passed as avatar.id)

image_uristring

Access URL of the character image

namestring

Display name

statusstring

Describes the generation status. See "status Enum" below for valid values.

created_attimestamp

Creation time

updated_attimestamp

Update time

status Enum

Value	Meaning
created (1)	Created, waiting for description generation
processing (6)	Generating description
success (11)	Generation succeeded
failed (12)	Generation failed (final state; re-creation required)

3. Retrieve a Character Asset

curl "https://api.vidu.cn/live/v1/avatars/{id}" \
  -H "Authorization: Token vda_xxx"

4. Delete Character Asset

curl -X DELETE "https://api.vidu.cn/live/v1/avatars/{id}" \
  -H "Authorization: Token vda_xxx"

List Query

curl "https://api.vidu.cn/live/v1/avatars?pager.page=0&pager.pagesz=10" \
  -H "Authorization: Token vda_xxx"

pager.pageinteger

Page number, starting from 0. Default: 0

pager.pageszinteger

Number of items per page. Default: 10, maximum: 100