Create Avatar

Create an avatar when you need a reusable on-camera identity for one or more UGC videos. Avatar creation is asynchronous: the create request returns an avatar ID right away, then the avatar becomes usable for video generation after its status changes to ready.

Use Create avatar API for the complete request and response reference.

Choose an avatar source

Sume supports three avatar sources. Pick the source based on how much creative control or reference material you have.

Prompt avatars
Photo avatars
Props avatars

Option 1: Prompt avatars

Use a prompt avatar when you want to describe the presenter in natural language. This works well for fast creative iteration, campaign-specific personas, and cases where you do not have an approved portrait reference.

Option 2: Photo avatars

Use a photo avatar when you have an approved portrait URL and want the reusable avatar identity to be based on that visual reference. The image must be reachable by Sume at request time.

Option 3: Props avatars

Use a props avatar when your app collects structured profile choices instead of free-form prompts. This is useful for productized avatar builders where users pick from controlled options.

Use the avatar

After creation, poll Get avatar until the avatar is ready. Save the returned avatar ID and pass it to Generate UGC Video as avatar.avatar_id.

Create the avatar

Choose prompt, photo, or props and send the matching fields.
Wait for readiness

Poll the avatar or provide webhook_url to receive avatar.ready or avatar.failed.
Reuse the avatar ID

Generate multiple videos with the same ready avatar by changing the script, product image, scene, or ratio.