FLUX 3 Keyframes to Video API

blackforestlabs/flux-3/keyframes-to-video

FLUX 3 Keyframes to Video places up to 10 keyframes along a 24 fps timeline to direct 5–20 seconds of continuous video with optional synchronized native audio. Choreograph complex shot sequences, character staging, and camera transitions across precise temporal anchors.

Input
133/20000
1/10 · 0–120
#1Start
Frame index
Output
Idle

Your generated video will appear here

Add your prompt and required media, review the settings, then click Run.

720p · 5 sec × 34/sec = $0.850 (170 credits)
Continue with

Examples

Seamless 5-second sequence connecting the three key poses: the skater crouches and pops the board, rises into a level ollie, then lands and rolls away. Camera: low tracking shot at board height, steady lateral move. Lighting: late afternoon plaza sun. Native audio: board pop, wheels on concrete, a soft landing. No logos, no readable text, no products, no packaging, no prices, no CTA, no advertising, no watermark, no brand marks.

Seamless 5-second home-kitchen sequence connecting the key poses: sliced vegetables on the board, then sliding into the pan with a toss, then plated. Camera: steady overhead-to-45-degree transitions between beats. Lighting: warm morning kitchen light. Native audio: knife taps, pan sizzle, a plate set down. No logos, no readable text, no products, no packaging, no prices, no CTA, no advertising, no watermark, no brand marks.

Seamless 5-second hiking montage connecting the key poses: walking a shaded forest path, stepping across a shallow rocky creek, then standing at the open summit overlook. Same hiker and backpack throughout. Camera: smooth following shots with natural transitions. Lighting: consistent midday mountain light. Native audio: footsteps on soil, creek water, summit wind. No logos, no readable text, no products, no packaging, no prices, no CTA, no advertising, no watermark, no brand marks.

FLUX 3 Keyframes to Video

FLUX 3 Keyframes to Video gives creators temporal directing control for multi-shot blocking and complex visual effects. Position up to 10 keyframes along a 24 fps timeline to establish critical story moments, and let the model synthesize physical dynamics, camera movement, and native audio connecting each frame.

Why Choose This?

  • 24 fps timeline precisionPin keyframes to exact frame indices (0–480) on a 24 fps timebase, precisely commanding when visual beats occur in the edit.

  • Choreograph up to 10 keyframesPosition 1 to 10 still frames in a single task, enabling complex multi-beat sequences and diverse viewpoint changes.

  • Positioned KeyframesPosition each image with frame_index and use the prompt to direct subject motion and camera changes.

  • Prompt-coordinated directionUse prompt text to choreograph intermediate actions and camera pans between keyframes, turning stills into dynamic storytelling.

  • Timeline-synchronized native soundGenerates audio that shifts alongside keyframe progression, matching room tones, foley, and music to evolving scene geometry.

  • Production-ready 720p and 1080pDelivers sharp 720p and 1080p renders that maintain edge integrity and textural depth across complex motion sequences.

Parameters

ParameterRequirementDescription
promptRequired

String. Directs motion transitions, camera movements, and native audio cues connecting each temporal keyframe.

keyframesRequired

1–10 keyframe objects, each with a public image URL and a unique integer frame_index from 0 through duration × 24 inclusive.

durationOptional

Integer. Sets output video duration in seconds from 5 to 20; the Playground preselects 5 seconds.

Default5
resolutionOptional

String. Sets output resolution to 720p or 1080p; the Playground preselects 720p.

Default720p1080p
aspect_ratioOptional

String. Controls framing ratio, supporting auto and standard formats; the Playground preselects auto.

Defaultauto21:92:116:94:31:13:49:16
soundOptional

Boolean. Controls whether native synchronized audio is generated alongside video; default is true.

Defaulttruefalse

How to Use

  1. Plan timeline and keyframesCalculate frame indices at 24 fps and prepare 1–10 public image URLs. Keep indices unique and within 0 through duration × 24.

  2. Direct motion and transitionsIn prompt, describe how the subject advances across successive keyframes, detailing camera movement and audio cues.

  3. Set total durationSpecify an integer duration between 5 and 20 seconds, verifying all frame_index values fall within duration × 24.

  4. Choose resolution and aspect ratioPick 720p or 1080p resolution and set an appropriate aspect ratio or leave set to auto.

  5. Configure sound settingKeep sound set to true to synthesize matching audio cues across the timeline, or set to false for silent video.

  6. Generate and review sequenceConfirm the estimated credits, click Run, and inspect the continuous motion linking your keyframes before downloading.

Pricing

Billed per output second by resolution tier, including native synchronized audio. 1 credit = $0.005.

UsageRateDetails
720p34 credits / sec ($0.17 / sec)Default 5s at 720p is 170 credits ($0.85).
1080p58 credits / sec ($0.29 / sec)5s at 1080p is 290 credits ($1.45).

Best Use Cases

  • Storyboard directing and blockingMap consecutive storyboard panels onto an explicit timeline, turning concept art into continuous cinematic footage.

  • Complex character choreographyPin key performance postures at exact seconds, generating natural dance, acrobatics, or sports sequences.

  • Multi-angle product showcaseAnchor front, profile, and macro shots at designated beats to produce a seamless 360-degree commercial reel.

  • Time-lapse environmental shiftsPlace dawn, midday, and twilight stills along the timeline to create atmospheric day-to-night transitions.

Pro Tips

  • Remember the 24 fps formula: 1s = 24 frames, 2.5s = 60 frames, 5s = 120 frames, with maximum index equal to duration × 24.
  • Choose keyframe positions for the intended shot, keeping every frame_index unique and within the output timeline.
  • Keep intervals between adjacent keyframes at 12 frames (0.5s) or more to give the physical engine room to interpolate naturally.
  • Sequence prompt directions to match timeline beats, e.g., 'dolly right for first 2 seconds, then push into close-up'.
  • Coordinate sound design with critical visual beats, such as 'heavy door latch clicks shut exactly at the close-up'.

Notes

  • 1–10 keyframe objects, each with a public image URL and a unique integer frame_index from 0 through duration × 24 inclusive.
  • Every frame_index must fall within the range 0 to duration × 24 and must be distinct.
  • After submission via API, record the returned task_id to poll progress and download the completed asset.
  • Rendered videos are output in standard MP4 format and can be dropped directly into timelines to link neighboring shots.

FLUX 3 Keyframes to Video API frequently asked questions

What is the FLUX 3 Keyframes to Video API?

FLUX 3 Keyframes to Video is a Black Forest Labs model for interpolating continuous video across multiple chronological keyframes positioned along a timeline. It empowers creators to place up to 10 still frames onto a 24 fps timebase, generating 5 to 20 seconds of cinematic footage up to 1080p resolution with optional synchronized native audio. Rooted in multi-anchor spatiotemporal interpolation, it seamlessly unites shot transitions, character staging, and lighting changes for director-level storyboard execution. You can call it programmatically or try it from the playground above.

How is the 24 fps timeline frame index calculated for keyframes?

The timeline runs on a fixed 24 fps base. The integer frame_index is calculated as seconds × 24 (e.g., 0s = 0, 1s = 24, 2.5s = 60, 5s = 120, 20s = 480). All specified frame_index values must fall within the range 0 to duration × 24.

Does the first keyframe index have to be 0?

No. Every keyframe follows the same rule: frame_index must be an integer from 0 through duration × 24 and must not repeat another keyframe index.

How many keyframes are supported and what is the ideal spacing?

The keyframes array accepts 1 to 10 objects. To ensure fluid physics transitions, maintaining a spacing of at least 12 frames (0.5 seconds) between adjacent keyframes is recommended.

How should prompts be written to coordinate multiple keyframes?

Describe the narrative flow chronologically across the sequence. For example, 'smooth tracking from initial stance toward the second beat, then tilting up toward the final posture' guides the interpolation engine through successive anchors.

How is synchronized native audio synthesized across keyframes?

When sound is set to true, the model evaluates visual progressions across all keyframes alongside prompt audio cues to synthesize matching dynamic sound effects and ambient room tones aligned with each temporal point.

Which endpoint is recommended if I only need start and end anchors?

If your shot requires only an opening still and a closing still, the FLUX 3 First Last Frame to Video endpoint is recommended, as it accepts a simple 2-item array without requiring 24 fps frame index calculations.