# FLUX 3

> Black Forest Labs' multimodal FLUX 3 generates 5-20 second video with synchronized audio from a text prompt, from one or more images (first frame, first+last frame, or a storyboard of up to 10), or by continuing an existing clip — at 720p or 1080p, with a low-cost draft mode.

- **Provider**: replicate
- **Model ID**: black-forest-labs/flux-3
- **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` (string, optional): Length of the generated clip in seconds ("5"-"20"). Defaults to "5" when omitted. 'auto' lets the model pick a length (5-20s) to fit the content and is billed at the 20-second maximum. Three or more images need an explicit duration. (Default: `5`; Options: `auto`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`)
- `aspect_ratio` (string, optional): Aspect ratio of the generated video. 'auto' picks a ratio from your prompt and any inputs. (Default: `auto`; Options: `auto`, `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`)
- `images` (array, optional): Optional images to drive the video, placed on screen pixel for pixel. One image opens the clip (image-to-video). Two images start and end it. Three or more (up to 10) become a storyboard — the first starts it, the last ends it, and the rest fall evenly in between (needs an explicit duration). Leave empty for text-to-video. PNG, JPEG, or WebP. Can't be combined with start_video. (Default: `[]`)
- `safety_tolerance` (integer, optional): Moderation tolerance for input and output, 0 (strictest) to 4 (most permissive). Requests with image or video inputs are limited to 2. (Default: `2`; Range: min: 0, max: 4)
- `draft` (boolean, optional): Generate a fast, low-cost draft preview instead of a full-quality clip. Drafts are 720p. (Default: `False`)
- `start_video` (string, optional): A video to continue from its final frames (video-to-video, billed at the higher video-continuation rate). Use this to extend a shot or chain generations into a longer sequence. Must be an mp4, at most 50MB and 15 seconds. Can't be combined with images.
- `generate_audio` (boolean, optional): Generate synchronized audio (ambient sound, speech, effects). Set to false for a silent clip. (Default: `True`)
- `prompt` (string, **required**): Text description of the video to generate. Plain language works — the prompt is interpreted and expanded before generation. Describe the scene, action, camera moves, and any audio you want.
- `resolution` (string, optional): Output resolution. Ignored in draft mode (drafts are 720p). (Default: `720p`; Options: `720p`, `1080p`)

## Example Request

```json
{
  "model": "black-forest-labs/flux-3",
  "input": {
    "duration": "5",
    "aspect_ratio": "auto",
    "images": [],
    "safety_tolerance": 2,
    "draft": false,
    "generate_audio": true,
    "prompt": "a home video of a futuristic san francisco with people riding hoverboards",
    "resolution": "720p"
  }
}
```

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

url

## Tags

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

## Documentation

https://replicate.com/black-forest-labs/flux-3