Video templates

Generate MP4 clips with dynamic text and images

Video templates produce MP4 clips by animating layers across a timeline. Renders are generated by ffmpeg compositing Konva snapshots.

Differences vs image templates

	Image	Video
Output	PNG/JPEG	MP4 + thumbnail JPEG
Render time	Seconds	Tens of seconds to minutes
Endpoint	POST /v1/images	POST /v1/videos
Extra fields	—	duration_seconds, fps

Animation primitives

Each layer can declare a keyframes array:

{
  "name": "title",
  "type": "text",
  "keyframes": [
    { "t": 0,   "opacity": 0, "y": 540 },
    { "t": 0.5, "opacity": 1, "y": 500 },
    { "t": 4.5, "opacity": 1, "y": 500 },
    { "t": 5,   "opacity": 0, "y": 460 }
  ]
}

t is seconds. Imtegrate interpolates linearly between keyframes.

Triggering a video render

curl -X POST https://api.imtegrate.com/v1/videos \
  -H "Authorization: Bearer $IMTEGRATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_promo",
    "modifications": [
      { "name": "headline", "text": "New collection drops Friday" }
    ]
  }'

Response includes id, status: "pending". The completed render has both result_url (MP4) and thumbnail_url (JPEG poster frame).

Limits

• Max duration: 60 seconds (free plan)
• Max resolution: 1920×1080
• Frame rate: 24, 30, or 60 fps