TraceeDocs

Clips

Make an AI actor ad

A 20-25 second vertical ad with an AI actor talking about the product: scripted, cast, voiced, lip-synced, with b-roll and captions. Pass url (product page) and/or prompt. About 5 minutes and about $1.50 in credits; returns ai_video_id.

POSThttps://traceeai.com/api/v1/ai-actor-videos

CLI:tracee clips ai-actor·MCP:mediaaction ai_actor

Authorizations

  • Authorizationstringheaderrequired

    Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

  • Tracee-Workspacestring

    For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.

    uuid

Body

application/json
  • urlstring

    uri

  • promptstring

    3–4,000 characters

  • languagestring

    The script's language

    2–5 characters

  • stylestring

    The script's style; default ugc

    Available options:ugceducationalshockstorycomparison

  • genderstring

    The actor

    Available options:femalemale

  • voicestring

    An ElevenLabs voice id (default by gender)

    up to 40 characters

Response

Errors
  • 200Already done.

    The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.

  • 202Started or still running: follow it with the id in the answer.

    The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.