|Docs

Sume UGC 1.0

Sume UGC 1.0 is a two-step flow for creating reusable avatar identities and turning them into UGC videos.

  • Create an avatar - Create an avatar from a prompt, photo, or structured profile.
  • Generate a video - Generate a UGC video from an existing avatar ID, script, and product image.

Base URL

Authentication

Create an API key from the Sume dashboard, then send it in the x-api-key header on every request.

How it works

Start with an avatar, then use that avatar to make videos. Each step has multiple options so you can match your product flow.

  1. Avatar Creation

    Create a reusable avatar identity from a prompt, a portrait photo, or structured profile fields.

  2. UGC Video Generation

    Generate UGC videos from a ready avatar with options for script, product or reference image, scene, and output ratio.

Errors

Error responses use a consistent error envelope:

Common error codes include unauthorized, bad_request, not_found, avatar_not_ready, insufficient_credits, rate_limit_exceeded, and internal_error. The details field is included when validation, billing, or rate-limit context is available.