# Flux 3 Image to Video

> 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.

- **Provider**: fal
- **Model ID**: blackforestlabs/flux-3/image-to-video
- **Category**: video_generation
- **Credits**: 1980 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `duration` (integer, **required**): 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. (Default: `5`; Range: min: 5, max: 20)
- `aspect_ratio` (string, optional): Aspect ratio of the generated video. 'auto' lets the model choose. (Default: `auto`; Options: `auto`, `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`)
- `safety_tolerance` (integer, optional): The safety tolerance level for the generated video. 0 is the strictest and 4 is the most permissive. (Default: `2`; Range: min: 0, max: 4)
- `image_url` (string, **required**): URL of the image the video starts from (PNG, JPEG, or WebP).
- `generate_audio` (boolean, optional): Whether to generate audio for the video. (Default: `True`)
- `prompt` (string, **required**): The text prompt describing the video you want to generate.
- `resolution` (string, optional): Resolution of the generated video. (Default: `720p`; Options: `720p`, `1080p`)

## Example Request

```json
{
  "model": "blackforestlabs/flux-3/image-to-video",
  "input": {
    "duration": 5,
    "aspect_ratio": "auto",
    "generate_audio": true,
    "prompt": "A red panda walks along a mossy log in a sunlit forest, one continuous unbroken shot. Ambient birdsong and rustling leaves.",
    "resolution": "720p",
    "image_url": "https://storage.googleapis.com/falserverless/example_inputs/veo31_i2v_input.jpg"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

black-forest-labs, flux, video-generation, image-to-video, native-audio

## Documentation

https://fal.ai/models/blackforestlabs/flux-3/image-to-video