Create new avatar

There are three ways to make an avatar:

  1. Prompt: describe the avatar you want.
  2. Profile: provide structured traits for the avatar.
  3. Image: use a reference image.

Each request creates a job. Poll the job until it completes, then use the returned avatar handle or resource id to generate avatar videos.

Avatar creation uses a top-level avatar_handle plus an input union. The handle may include a leading @; Sume stores it normalized without @.

1. Prompt

Use this when you want to create an avatar from text only.

2. Profile

Use this when your app already has profile details for the avatar. In the API, this uses the props input type.

3. Image

Use this when you have a reference image. In the API, this uses the photo input type.

image_url must be a fetchable public HTTPS image URL. Localhost, private-network URLs, non-HTTPS URLs, and non-image responses are rejected before generation submission.

Poll the job

Fetch the result when the job is completed.

Next

Use the returned avatar handle on Generate avatar video.