Videomaker

Updated 9 Nov 20263 min read

Send "type": "videomaker".

Create an editable motion VIDEO (render_videomaker) in a MockFlow IdeaBoard Video Maker frame: explainers, product launch and promo videos, app tutorials, animated social posts and reels, ads, intros and logo reveals, data stories, event promos. You write the video as a sequence of SCENES, each one finished graphic design page of positioned text, shapes, pictures and lines brought to life by motion, as JSON, never HTML or CSS; MockFlow plays it, the user edits every scene and exports it as MP4. For a still graphic use render_design; for a generated footage clip use render_video.

Also available as the MCP tool render_videomaker. The same payload works through either surface.

Fields

data

titlestring

Short video name shown as the frame title

wnumberrequired

Canvas width in px

hnumberrequired

Canvas height in px

lookobject

Shared look of pictures that belong together: {"style","cast":[{"id","description"}]} (keep it, with any "ref", when modifying)

musicstring

ONLY when the user asks for music, a soundtrack or sound. Best: a real track that allows reuse, found with WebSearch/WebFetch, as "web::" followed by the direct audio file URL (Wikimedia Commons, Free Music Archive, Pixabay, Incompetech, or the artist's own free download; a URL you saw in a page you fetched, never one you composed); MockFlow imports it free. Otherwise the music in a few words (genre, mood, tempo, main instruments; instrumental) and MockFlow makes it. Leave it out when not asked, and when modifying a video whose "sound" already has music.

scenesobject[]required

The scenes in order

Child attributes

idstring

Only when modifying: the id of a scene kept from the existing video

durnumberrequired

Seconds on screen

transobject

How the scene arrives from the one before (the first scene has none). A scene that continues the one before uses "morph" (Smart move) on the SAME "bg": what recurs (same text, picture or shape, the headline, or a shared "link") travels, resizes and recolours into its new place instead of cutting. Other effects only where the story changes chapter.

camobject

A slow camera move through the scene, so the frame is never fully still

bgany

Scene background: "#rrggbb" or a gradient object

bgImgobject

Scene picture behind everything {"src","op"} (keep it when modifying)

elsobject[]required

The elements in drawing order (first at the back): the design element schema, plus "anim" and "link", plus at most ONE footage clip per scene: {"type":"clip","x","y","w","h","src":"web::<direct video file URL>", optional "trim":[startSec,endSec]} (see FOOTAGE)

saystring

ONLY when the user asks for a voiceover, narration or sound (or the video being modified already has "say" lines: keep them word for word unless the change is about them): what the narrator says while this scene shows, one or two short spoken sentences that add to the words on screen rather than reading them out, about 2.5 words per second of "dur" (never more than 3; lengthen "dur" for more words). The lines flow as one story. No stage directions, emoji or hashtags. MockFlow reads it aloud and adds captions.

Example

{
  "type": "videomaker",
  "data": {
    "title": "Q4 Launch Planning",
    "w": 0,
    "h": 0,
    "look": {},
    "music": "string",
    "scenes": [
      {
        "id": "string",
        "dur": 0,
        "trans": {
          "fx": "morph",
          "dur": 0,
          "color": "string"
        },
        "cam": {
          "fx": "push-in",
          "amt": 0
        },
        "bg": "string",
        "bgImg": {},
        "els": [
          {
            "id": "string",
            "type": "text",
            "x": 0,
            "y": 0,
            "w": 0,
            "h": 0,
            "rot": 0,
            "op": 0,
            "text": "Interview 5 users",
            "font": "string"
          }
        ],
        "say": "string"
      }
    ]
  }
}

Was this page helpful?