Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mosaic.so/llms.txt

Use this file to discover all available pages before exploring further.

Video Generation creates new video clips from text prompts. Use it when you want AI-generated footage rather than an edit of existing footage.

​
How It Works

Describe the shot, subject, style, camera motion, and desired duration. Mosaic sends the prompt and any selected image, video, or audio references to the generation model, then returns a video asset that can feed downstream tiles. Use Video Generation for:
  • Product shots and cinematic b-roll
  • Social clips from a creative prompt
  • Reference-guided motion from uploaded images or clips
  • Sound-enabled generated scenes

​
API Usage

Create an agent shell: 
curl -X POST "https://api.mosaic.so/agent/create" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Seedance product shot",
    "visibility": "private"
  }'
Add a Video Generation node: 
curl -X POST "https://api.mosaic.so/agent/AGENT_ID/update" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "operations": [
      {
        "op": "create_node",
        "node_type_id": "a2eb3ec2-da7a-4f97-94d2-a9a537548522",
        "params_used": {
          "prompt": "A cinematic handheld shot of a matte black water bottle on a mountain trail at sunrise",
          "model": "seedance-2",
          "resolution": "720p",
          "duration": "8",
          "aspect_ratio": "9:16",
          "generate_audio": true
        }
      }
    ]
  }'
Then run the agent with no video inputs: 
curl -X POST "https://api.mosaic.so/agent/AGENT_ID/run" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-webhook.com/mosaic"
  }'

​
API Info

  • Node ID: a2eb3ec2-da7a-4f97-94d2-a9a537548522

​
Node params

ParamTypeRequiredDefaultNotes
promptstringYes""Generation prompt.
model"seedance-2"No"seedance-2"Video model.
resolution"480p" | "720p" | "1080p"No"720p"Requested output resolution.
duration"auto" | "4" ... "15"No"auto"Duration in seconds, or automatic model choice.
aspect_ratio"auto" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16"No"auto"Output aspect ratio.
generate_audiobooleanNotrueGenerate synchronized audio when supported.
selected_context{images:string[],videos:string[],audio:string[]}Noempty listsUploaded references to guide generation.

​
Example

{
  "prompt": "A cinematic macro shot of coffee pouring into a glass mug",
  "model": "seedance-2",
  "resolution": "720p",
  "duration": "8",
  "aspect_ratio": "16:9",
  "generate_audio": true
}