TraceeDocs

Media

Generate a video with AI

A short clip with sound for one platform (vertical 1080×1920 or landscape 1920×1080). Describe one continuous shot; video models can't write text. One to three minutes: follow it with GET /media/generations/{generation_id}.

POSThttps://traceeai.com/api/v1/media/videos

CLI:tracee media generate-video·MCP:mediaaction generate_video

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

Query parameters

  • waitinteger

    Seconds to wait for the job before answering (0-290; default 50). If it isn't done by then the answer is 202 with its id to follow.

    0–290

Body

application/json
  • promptstringrequired

    3–4,000 characters

  • platformstring

    Where it will be posted. The channel's platform (linkedin, instagram, facebook, x, threads, tiktok, youtube, pinterest, reddit, google_business, devto, hashnode) or a placement: instagram_story, facebook_story, youtube_short. youtube alone is a thumbnail (image) or a landscape video

    Available options:linkedininstagraminstagram_storyfacebookfacebook_storyxthreadstiktokyoutubeyoutube_short

  • aspect_ratiostring

    Only without platform: 1:1 square (default for images), 4:5 portrait, 9:16 vertical (default for video), 16:9 landscape

    Available options:1:14:53:49:1616:9

  • durationinteger

    Seconds, default 8

    2–15

  • first_frame_media_idstring

    An image to start from and bring to life. From POST /api/v1/media/images

    uuid

  • audioboolean

    With sound; default true

  • brandboolean

    Follow the brand profile; default true. false for an off-brand image

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.