FLUX.3 is Black Forest Labs' frontier video model. This endpoint animates a single still image into coherent, natural motion at 720p or 1080p for 5-20 seconds, with synchronized audio generated alongside the video and a tunable safety tolerance.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "A red panda walks along a mossy log in a sunlit forest, one continuous unbroken shot. Ambient birdsong and rustling leaves.",
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | - | The text prompt describing the video you want to generate. |
image_url | string | Yes | - | URL of the image the video starts from (PNG, JPEG, or WebP). |
duration | integer | Yes | 5 | Duration of the generated video in seconds (5-20). Required โ upstream also accepts "auto", but the resulting length is unknown at request time and cannot be billed accurately, so this gateway requires an explicit duration. |
resolution | string | No | 720p | Resolution of the generated video. 720p1080p |
aspect_ratio | string | No | auto | Aspect ratio of the generated video. 'auto' lets the model choose. auto21:92:116:94:31:13:49:16 |
generate_audio | boolean | No | true | Whether to generate audio for the video. |
safety_tolerance | integer | No | 2 | The safety tolerance level for the generated video. 0 is the strictest and 4 is the most permissive. |
There are 3 ways to provide files for the image_url parameter:
Pass a publicly accessible URL directly. With the Storage API (POST /v1/files/upload-url) the file uploads straight to S3 (50MB per file) and you pass the returned file_url.
{
"model": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "your prompt here",
"image_url": "https://example.com/image.jpg"
}
}Attach files directly to POST /v1/predictions/upload. No separate upload step, but the bytes pass through the API server so the whole request is capped at 10MB.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=blackforestlabs/flux-3/image-to-video" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:image_url=@your_file.png"Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
Animate a photograph into one unbroken 5-second take at 720p, with ambient sound generated alongside.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "A red panda walks along a mossy log in a sunlit forest, one continuous unbroken shot. Ambient birdsong and rustling leaves.",
"image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto",
"generate_audio": true
}
}'Render the final cut at 1080p in a 16:9 frame once the motion has been validated at 720p.
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "blackforestlabs/flux-3/image-to-video",
"input": {
"prompt": "Slow dolly-in on a ceramic coffee cup as steam rises, morning light through a window, shallow depth of field.",
"image_url": "https://example.com/product-still.jpg",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}'POST /v1/predictions