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

- 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]
}'
{
"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"
{
"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"
}]
}
}]
}]
}
}'
{
"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.