FLUX 3 Max Keyframes to Video

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "blackforestlabs/flux-3-max/keyframes-to-video",
  "input": {
    "keyframes": [
      {
        "image_url": "https://example.com/seed.png",
        "frame_index": 0
      },
      {
        "image_url": "https://example.com/sapling.png",
        "frame_index": 60
      },
      {
        "image_url": "https://example.com/blossom.png",
        "frame_index": 120
      }
    ],
    "prompt": "A seed sprouts, grows into a sapling and blossoms into a cherry tree, time-lapse, fixed camera",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "sound": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "blackforestlabs/flux-3-max/keyframes-to-video",
  "input": {
    "keyframes": [
      {
        "image_url": "https://example.com/seed.png",
        "frame_index": 0
      },
      {
        "image_url": "https://example.com/sapling.png",
        "frame_index": 60
      },
      {
        "image_url": "https://example.com/blossom.png",
        "frame_index": 120
      }
    ],
    "prompt": "A seed sprouts, grows into a sapling and blossoms into a cherry tree, time-lapse, fixed camera",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "sound": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

FLUX 3 Max Keyframes to Video lets you pin up to 10 images to exact positions on a 24 fps timeline and generates the motion between them. It is built for storyboard animatics, product transformations and time-lapse style sequences where specific shots must appear at specific moments. FLUX 3 Max is a video model post-trained by fal in collaboration with Black Forest Labs on the FLUX 3 video base. Vidgo exposes it as three model IDs: Text to Video, Image to Video and Keyframes to Video.

Models

blackforestlabs/flux-3-max/keyframes-to-video — Keyframes-to-video with FLUX 3 Max, 1–10 images placed by frame_index.

Features

Keyframe control with 1–10 images, each placed on a frame of a 24 fps timeline.
Integer durations from 5 to 20 seconds at 720p or 1080p.
Eight aspect ratios; auto follows the first keyframe image.
Native audio on by default.

Required parameters

keyframes (object[]): 1–10 objects, each with exactly two fields:
- image_url (string): Public HTTP(S) URL of the keyframe image (PNG, JPEG or WebP).
- frame_index (integer): Position of that image on the 24 fps timeline, from 0 to duration × 24. Indexes must be unique.
prompt (string): The motion and transitions between keyframes, the camera movement and, with sound on, the audio. Must not be blank.

Optional parameters

duration (integer): Output length in seconds, 5–20. Default 5.
resolution (string): 720p or 1080p. Default 720p.
aspect_ratio (string): auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4 or 9:16. Default auto.
sound (boolean): Generate native audio with the video. Default true; set false for silent footage.

Duration

frame_index counts frames at 24 fps, so the last valid index depends on duration:

`duration`	Valid `frame_index` range
5	0–120
10	0–240
15	0–360
20	0–480

To place an image at second t, use frame_index = t × 24 (for example 2.5 s → 60).

Output

The finished task returns one MP4 video in the files array of Query Task Status and the callback payload.

Examples

Three keyframes over 5 seconds: seed, sapling and blossom at frames 0, 60 and 120 (start, middle and end of a 5-second clip).
10-second 1080p storyboard with callback: four shots at frames 0, 96, 168 and 240, 21:9, silent, with a callback_url.

Notes

A frame_index above duration × 24, a repeated index, or extra fields inside a keyframe object return 400. If you shorten duration, check that every index still fits.
Fields not listed above, such as image_urls, return 400. For a simple start/end frame clip, use FLUX 3 Max Image to Video.
Credits are reserved at submission and depend on resolution and duration. The rate is the same for text-to-video, image-to-video and keyframes-to-video, and sound does not change it. A failed task is refunded in full. See the pricing page for current rates.
There is no 4K tier, no seed and no output longer than 20 seconds on this model.

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication

Get your API Key:

Go to Dashboard → API Key (API Key Management Page) to get your API Key

Add it to the request header:

Authorization: Bearer VIDGO_API_KEY

Body

application/json

model

string

required

Model ID. Use blackforestlabs/flux-3-max/keyframes-to-video.

Example:

"blackforestlabs/flux-3-max/keyframes-to-video"

input

object

required

Generation parameters.

Show child attributes

callback_url

string<uri> | null

Optional public HTTP(S) endpoint that receives a POST when the task becomes finished or failed. HTTPS is recommended. Omit it, or send null or an empty string, to disable callbacks.

Example:

"https://your-domain.com/callback"

Response

Task submitted

code

enum<integer>

required

HTTP status code.

Available options:

200

data

object

required

Show child attributes

​Models

​Features

​Required parameters

​Optional parameters

​Duration

​Output

​Examples

​Notes

Authorizations

Body

Response

Models

Features

Required parameters

Optional parameters

Duration

Output

Examples

Notes