Become a founding member.

← All endpoints
API endpoint

Video Editor

Send a timeline as JSON, look at stills, get an MP4

A title lands, then three vertical clips rise into a row under it.
What goes in
A timeline: scenes, tracks of clips and text, keyframes, captions, audio. Clips are any public https link.
What comes out
Still frames in seconds, then an MP4.
What it costs
Stills and rendering are 0 credits today. Changing a cut in English uses your daily AI allowance, and past it a paid account pays in credits and a free one is refused. Limits apply per account. Free accounts get a small Made with Wireflow mark on the file. Paid accounts do not.

The call

Plain HTTP, no SDK to install. Set WIREFLOW_API_KEY first. The key needs workflows:execute, renders:execute, workflows:write.

See it first

Stills come back in seconds, so you fix the cut before you render it.

curl -X POST https://www.wireflow.ai/api/v1/render/remotion/preview \
  -H "Authorization: Bearer $WIREFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "sceneGraph": {
    "fps": 30,
    "width": 1920,
    "height": 1080,
    "background": "#07080f",
    "scenes": [{
      "type": "color",
      "color": "#07080f",
      "durationInFrames": 180
    }],
    "tracks": [{
      "id": "clips",
      "clips": [{
        "id": "news",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/news-reel-eclipse-hd.mp4",
        "muted": true,
        "startFrame": 40,
        "durationInFrames": 140,
        "width": 394,
        "height": 700,
        "x": -470,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }, {
        "id": "dive",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/captioned-short-dive-hd.mp4",
        "muted": true,
        "startFrame": 48,
        "durationInFrames": 132,
        "width": 394,
        "height": 700,
        "x": 0,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }, {
        "id": "ugc",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/ugc-ad-nobody-hd.mp4",
        "muted": true,
        "startFrame": 56,
        "durationInFrames": 124,
        "width": 394,
        "height": 700,
        "x": 470,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }]
    }, {
      "id": "titles",
      "clips": [{
        "id": "title",
        "kind": "text",
        "text": "Three clips, one timeline",
        "fontFamily": "Inter Tight",
        "fontWeight": "bold",
        "fontSize": 132,
        "letterSpacing": -0.03,
        "color": "#ffffff",
        "width": 1760,
        "startFrame": 0,
        "durationInFrames": 180,
        "reveal": {
          "style": "mask-up",
          "unit": "word",
          "durationInFrames": 16,
          "staggerFrames": 3
        },
        "keyframeTracks": {
          "y": [{
            "frame": 28,
            "value": 0
          }, {
            "frame": 56,
            "value": -400,
            "easing": "easeInOutCubic"
          }],
          "scale": [{
            "frame": 28,
            "value": 1
          }, {
            "frame": 56,
            "value": 0.58,
            "easing": "easeInOutCubic"
          }]
        }
      }]
    }]
  },
  "samples": [0.1, 0.5, 0.9]
}'
Response
{
  "data": {
    "frames": [
      { "frame": 18, "url": "https://cdn.wireflow.ai/previews/…png" },
      { "frame": 90, "url": "https://cdn.wireflow.ai/previews/…png" },
      { "frame": 162, "url": "https://cdn.wireflow.ai/previews/…png" }
    ],
    "durationSeconds": 6,
    "renderable": true,
    "issues": [],
    "warnings": []
  }
}

Render the file

This is the timeline that made the sample above. It starts the render and waits for the file.

curl -X POST https://www.wireflow.ai/api/v1/render/remotion/render \
  -H "Authorization: Bearer $WIREFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "sceneGraph": {
    "fps": 30,
    "width": 1920,
    "height": 1080,
    "background": "#07080f",
    "scenes": [{
      "type": "color",
      "color": "#07080f",
      "durationInFrames": 180
    }],
    "tracks": [{
      "id": "clips",
      "clips": [{
        "id": "news",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/news-reel-eclipse-hd.mp4",
        "muted": true,
        "startFrame": 40,
        "durationInFrames": 140,
        "width": 394,
        "height": 700,
        "x": -470,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }, {
        "id": "dive",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/captioned-short-dive-hd.mp4",
        "muted": true,
        "startFrame": 48,
        "durationInFrames": 132,
        "width": 394,
        "height": 700,
        "x": 0,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }, {
        "id": "ugc",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/ugc-ad-nobody-hd.mp4",
        "muted": true,
        "startFrame": 56,
        "durationInFrames": 124,
        "width": 394,
        "height": 700,
        "x": 470,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }]
    }, {
      "id": "titles",
      "clips": [{
        "id": "title",
        "kind": "text",
        "text": "Three clips, one timeline",
        "fontFamily": "Inter Tight",
        "fontWeight": "bold",
        "fontSize": 132,
        "letterSpacing": -0.03,
        "color": "#ffffff",
        "width": 1760,
        "startFrame": 0,
        "durationInFrames": 180,
        "reveal": {
          "style": "mask-up",
          "unit": "word",
          "durationInFrames": 16,
          "staggerFrames": 3
        },
        "keyframeTracks": {
          "y": [{
            "frame": 28,
            "value": 0
          }, {
            "frame": 56,
            "value": -400,
            "easing": "easeInOutCubic"
          }],
          "scale": [{
            "frame": 28,
            "value": 1
          }, {
            "frame": 56,
            "value": 0.58,
            "easing": "easeInOutCubic"
          }]
        }
      }]
    }]
  }
}'

# It returns a renderId right away. Poll until it finishes.
curl "https://www.wireflow.ai/api/v1/render/remotion/render/progress?renderId=RENDER_ID&bucketName=BUCKET_NAME" \
  -H "Authorization: Bearer $WIREFLOW_API_KEY"
Response
{
  "status": "done",
  "videoUrl": "https://…mp4",
  "sizeBytes": 2268231
}

Change it in English

Send the current timeline and what you want. A checked timeline comes back, ready to preview. Nothing is saved or rendered. This call uses your daily AI allowance.

curl -X POST https://www.wireflow.ai/api/v1/render/remotion/generate \
  -H "Authorization: Bearer $WIREFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Make the title say Three clips, one call, and start the clips half a second later.",
  "currentSceneGraph": {
    "fps": 30,
    "width": 1920,
    "height": 1080,
    "background": "#07080f",
    "scenes": [{
      "type": "color",
      "color": "#07080f",
      "durationInFrames": 180
    }],
    "tracks": [{
      "id": "clips",
      "clips": [{
        "id": "news",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/news-reel-eclipse-hd.mp4",
        "muted": true,
        "startFrame": 40,
        "durationInFrames": 140,
        "width": 394,
        "height": 700,
        "x": -470,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }, {
        "id": "dive",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/captioned-short-dive-hd.mp4",
        "muted": true,
        "startFrame": 48,
        "durationInFrames": 132,
        "width": 394,
        "height": 700,
        "x": 0,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }, {
        "id": "ugc",
        "kind": "video",
        "src": "https://cdn.wireflow.ai/landing/api/ugc-ad-nobody-hd.mp4",
        "muted": true,
        "startFrame": 56,
        "durationInFrames": 124,
        "width": 394,
        "height": 700,
        "x": 470,
        "y": 130,
        "borderRadius": 28,
        "keyframeTracks": {
          "y": [{
            "frame": 0,
            "value": 1100
          }, {
            "frame": 26,
            "value": 130,
            "easing": "easeOutExpo"
          }]
        }
      }]
    }, {
      "id": "titles",
      "clips": [{
        "id": "title",
        "kind": "text",
        "text": "Three clips, one timeline",
        "fontFamily": "Inter Tight",
        "fontWeight": "bold",
        "fontSize": 132,
        "letterSpacing": -0.03,
        "color": "#ffffff",
        "width": 1760,
        "startFrame": 0,
        "durationInFrames": 180,
        "reveal": {
          "style": "mask-up",
          "unit": "word",
          "durationInFrames": 16,
          "staggerFrames": 3
        },
        "keyframeTracks": {
          "y": [{
            "frame": 28,
            "value": 0
          }, {
            "frame": 56,
            "value": -400,
            "easing": "easeInOutCubic"
          }],
          "scale": [{
            "frame": 28,
            "value": 1
          }, {
            "frame": 56,
            "value": 0.58,
            "easing": "easeInOutCubic"
          }]
        }
      }]
    }]
  }
}'
Response
{
  "sceneGraph": { "fps": 30, "width": 1920, "height": 1080, "…": "…" },
  "issues": [],
  "warnings": []
}

From Claude, the same editor is get_video_timeline, preview_video_frames and edit_video_timeline over MCP. Editing needs the "Create, edit and delete workflows" tick when you connect.