Generate avatar video

Avatar videos use the Sume-owned sume/avatar-video/v1.0 model-run endpoint and return job-backed resources. Use an existing ready avatar from GET /v1/avatars. Launch requests reference that avatar with top-level avatar_handle.

Scripts are accepted when Sume estimates the target video duration at 4-60 seconds inclusive. Shorten longer scripts or split them into multiple avatar-video jobs.

Create an avatar video

Avatar-video requests can include optional product or scene inputs where the OpenAPI schema permits them. Use scene: { "type": "prompt", "prompt": "..." } for scene direction or scene: { "type": "photo", "image_url": "https://..." } for a photo scene reference. Use public HTTPS URLs for product_image and scene image references.

Use quality: "standard" for the default execution path, plus for higher quality, or max when output quality is more important than turnaround time.

Poll and recover

Read avatar-video resources

Completed avatar videos can include public media.sume.com video artifacts.