Seasonal avatar host from a prompt, profile or photo for Christmas

Three inputs, one handle

To get a host you can reuse for a holiday campaign, call POST /v1/avatar-1.0/generate with an avatar_handle and one input: a prompt, a profile (props), or a reference image (photo). Poll the job, then use the returned handle in every later talking-video request.

The handle may include a leading @; Sume stores it normalized without the @. Make one handle per campaign host and reuse it, so every clip from Black Friday to Christmas shows the same person.

Profile and photo bodies

Use props when your app already has structured traits (ethnicity, sex and age appear in the docs example), and photo for a reference image that must be a fetchable public HTTPS image URL.

curl -sS -X POST https://api.sume.com/v1/avatar-1.0/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: holiday-host-001" \
  -d '{
    "avatar_handle": "holiday_host",
    "input": { "type": "props", "ethnicity": "Asian", "sex": "female", "age": 28 }
  }'

Which input to pick

Use the handle

Every request creates a job. When it is completed, read the avatar with GET /v1/avatar-1.0/avatars/{id}, then pass avatar_handle to the talking-video route or to Face swap. Use a photo of a real person only with their consent, and keep that consent on file with your campaign records.