Clipform

Assemble images and clips into a video

Generate a 9:16 vertical video from images, video clips, or a mix, synced to an audio track. Each image gets Ken Burns effects (zoom, pan). Video clips can be trimmed and muted. Output is uploaded to storage.

POST
/creative/montage

Authorization

Authorization
Required
Bearer <token>

API key (cf_*) passed as Bearer token

In: header

Request Body

application/jsonRequired
items
Required
array<object>
audio_urlstring

Audio track URL. Video duration matches audio length.

Format: "uri"
duration_secondsnumber

Total video duration. Required if no audio_url.

random_effectsboolean

Shuffle Ken Burns effects across images

Default: true
transitionobject
background_colorstring

Viewport background color

curl -X POST "https://api.clipform.io/v1/creative/montage" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "type": "image",
        "url": "http://example.com",
        "effect": "zoom-in",
        "aspect_ratio": 0,
        "fit": "cover",
        "start_from": 0,
        "volume": 1
      }
    ],
    "audio_url": "http://example.com",
    "duration_seconds": 0,
    "random_effects": true,
    "transition": {
      "type": "fade",
      "duration": 1
    },
    "background_color": "string"
  }'

Video generated

{
  "storage_path": "string",
  "public_url": "http://example.com",
  "signed_url": "http://example.com",
  "duration_seconds": 0
}