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.

Prefer the canonical Avatar 1.0 route:

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. See Media inputs.

Poll the job

Fetch the result when the job is completed.

Read avatar resources

Prefer the Avatar 1.0 resource routes:

Compatibility aliases

These older paths remain supported and share the same request body:

Alias	Notes
POST /v1/models/sume/avatar-1.0/generate/runs	Canonical model-run alias. Prefer /v1/avatar-1.0/generate for new integrations.
POST /v1/models/sume/avatar/v1.0/runs	Legacy launch alias.
GET /v1/avatars, GET /v1/avatars/:id	Compatibility list/read routes. Response shape matches /v1/avatar-1.0/avatars.

Next

Use the returned avatar handle on Generate avatar video. For first-frame review before a full render, see Avatar video previews.