> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apisale.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# FLUX 3 Standard — Image To Video
> Black Forest Labs FLUX 3 — first BFL video model, up to 20s with audio; text / image / first-last / keyframes / extend, plus Draft. Optimized for image to video via apisale.
## Overview
Black Forest Labs FLUX 3 — first BFL video model, up to 20s with audio; text / image / first-last / keyframes / extend, plus Draft. Optimized for image to video via apisale.
**Docs** = API contract + Try it (snapshot). **[Explore](https://apisale.ai/explore)** = browser playground. **[Model page](https://apisale.ai/models/blackforestlabs/flux-3/image-to-video)** = product examples.
## Endpoint
```http theme={null}
POST https://api.apisale.ai/v1/run/blackforestlabs/flux-3/image-to-video
```
| | |
| -------------- | --------------------------------------- |
| **Model slug** | `blackforestlabs/flux-3/image-to-video` |
| **Category** | Image to Video (`image-to-video`) |
| **Lab** | Blackforestlabs |
| **Tier** | Standard |
| **Mode** | async |
## Pricing
**From \$0.119/sec**
apisale price is **30%** below the vendor's official list price.
| Tier | Unit | Official price | apisale price |
| ----- | ------ | -------------- | ------------- |
| 720p | second | \$0.170 | \$0.119 |
| 1080p | second | \$0.290 | \$0.203 |
**Official price** = vendor list price. **apisale price** = what you pay through apisale.
## Request
```json theme={null}
{
"input": {
"prompt": "Vintage convertible on empty Pacific Coast Highway under magenta dusk, gentle camera drift, keep car identity",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"safety_tolerance": 2,
"image_url": "https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"
}
}
```
### Parameters
Fields marked \* are required. Use `Authorization: Key YOUR_API_KEY` for REST.
Text prompt describing the video to generate.
Duration in seconds (5-20), or auto to let the model choose. Default: `auto` Values: `auto`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`
URL of the image the video starts from (PNG, JPEG, or WebP).
Default: `720p` Values: `720p`, `1080p`
Aspect ratio; auto lets the model choose. Default: `auto` Values: `auto`, `21:9`, `2:1`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`
Whether to generate audio for the video. Default: `true`
0 is the strictest, 4 the most permissive. Default: `2` Range: 0 – 4
Optional HTTPS webhook when the run reaches a terminal state.
Block until completion (same Run response shape).
```json expandable theme={null}
{
"params": {
"prompt": {
"type": "string",
"required": true,
"description": "Text prompt describing the video to generate."
},
"duration": {
"type": "enum",
"values": [
"auto",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20"
],
"default": "auto",
"description": "Duration in seconds (5-20), or auto to let the model choose."
},
"image_url": {
"type": "media",
"required": true,
"description": "URL of the image the video starts from (PNG, JPEG, or WebP)."
},
"resolution": {
"type": "enum",
"values": [
"720p",
"1080p"
],
"default": "720p"
},
"aspect_ratio": {
"type": "enum",
"values": [
"auto",
"21:9",
"2:1",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"default": "auto",
"description": "Aspect ratio; auto lets the model choose."
},
"generate_audio": {
"type": "bool",
"default": true,
"description": "Whether to generate audio for the video."
},
"safety_tolerance": {
"max": 4,
"min": 0,
"type": "int",
"default": 2,
"description": "0 is the strictest, 4 the most permissive."
}
}
}
```
## Submit response
Returns a **Run** with `run_id`. Poll with [GET /v1/runs/\{run\_id}](/model-apis/poll-runs) or use **Try it** above.
Unique run ID — save for polling and webhooks.
`queued` (async) or terminal state for sync runs.
Result when `status` is `succeeded` — see **Output schema** below.
### Example (async submit)
```json theme={null}
{
"run_id": "run_550e8400-e29b-41d4-a716-446655440000",
"endpoint": "blackforestlabs/flux-3/image-to-video",
"model": "image-to-video",
"capability": "video",
"mode": "image-to-video",
"status": "queued",
"output": null,
"error": null,
"billing": null,
"created_at": "2026-06-27T12:00:00.000Z",
"started_at": null,
"completed_at": null,
"elapsed_ms": null
}
```
Full lifecycle: [Runs lifecycle](/model-apis/runs-lifecycle).
## Output
When `status` is `succeeded`, `output` follows this schema:
```json expandable theme={null}
{
"type": "object",
"example": {
"videos": [
{
"url": "https://example.com/out.mp4",
"content_type": "video/mp4"
}
]
},
"required": [
"videos"
],
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"content_type": {
"type": "string"
}
}
}
}
},
"description": "Succeeded task output: single video URL."
}
```
## Example
```bash theme={null}
curl -X POST "https://api.apisale.ai/v1/run/blackforestlabs/flux-3/image-to-video" \
-H "Authorization: Key YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Vintage convertible on empty Pacific Coast Highway under magenta dusk, gentle camera drift, keep car identity",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"safety_tolerance": 2,
"image_url": "https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png"
}
}'
```
## Related
* [FLUX 3 Draft — Image To Video](/api/video/blackforestlabs/flux-3/draft/image-to-video)
* [Runs lifecycle](/model-apis/runs-lifecycle)
* [Video API overview](/api/video)
* [Account API](/get-started/account-and-monitoring)
## OpenAPI
````yaml openapi-catalog.json POST /v1/run/blackforestlabs/flux-3/image-to-video
openapi: 3.0.3
info:
title: apisale Model Catalog
version: '2026-09-01T09:47:50.773Z'
description: Per-model OpenAPI operations for Mintlify Try playground.
servers:
- url: https://api.apisale.ai
security: []
paths:
/v1/run/blackforestlabs/flux-3/image-to-video:
post:
tags:
- Model catalog
- video
- Blackforestlabs
summary: Create FLUX 3 Standard — Image To Video
description: >-
Black Forest Labs FLUX 3 — first BFL video model, up to 20s with audio;
text / image / first-last / keyframes / extend, plus Draft. Optimized
for image to video via apisale.
operationId: submit-blackforestlabs-flux-3-image-to-video
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- input
properties:
input:
type: object
properties:
prompt:
description: Text prompt describing the video to generate.
type: string
duration:
description: >-
Duration in seconds (5-20), or auto to let the model
choose.
type: string
enum:
- auto
- '5'
- '6'
- '7'
- '8'
- '9'
- '10'
- '11'
- '12'
- '13'
- '14'
- '15'
- '16'
- '17'
- '18'
- '19'
- '20'
default: auto
image_url:
description: >-
URL of the image the video starts from (PNG, JPEG, or
WebP).
type: string
format: uri
resolution:
type: string
enum:
- 720p
- 1080p
default: 720p
aspect_ratio:
description: Aspect ratio; auto lets the model choose.
type: string
enum:
- auto
- '21:9'
- '2:1'
- '16:9'
- '4:3'
- '1:1'
- '3:4'
- '9:16'
default: auto
generate_audio:
description: Whether to generate audio for the video.
type: boolean
default: true
safety_tolerance:
description: 0 is the strictest, 4 the most permissive.
type: number
minimum: 0
maximum: 4
default: 2
required:
- prompt
- image_url
example:
prompt: >-
Vintage convertible on empty Pacific Coast Highway under
magenta dusk, gentle camera drift, keep car identity
duration: 5
resolution: 720p
aspect_ratio: '16:9'
generate_audio: true
safety_tolerance: 2
image_url: >-
https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png
webhook_url:
type: string
format: uri
sync:
type: boolean
default: false
example:
input:
prompt: >-
Vintage convertible on empty Pacific Coast Highway under
magenta dusk, gentle camera drift, keep car identity
duration: 5
resolution: 720p
aspect_ratio: '16:9'
generate_audio: true
safety_tolerance: 2
image_url: >-
https://assets.apisale.ai/permanent/official/google/nano-banana-2/example-t2i-01.png
responses:
'201':
description: Run accepted
content:
application/json:
schema:
$ref: '#/components/schemas/RunObject'
security:
- ApiKeyAuth: []
components:
schemas:
RunObject:
type: object
required:
- run_id
- endpoint
- model
- capability
- mode
- status
- created_at
properties:
run_id:
type: string
description: Unique run identifier
endpoint:
type: string
description: Model slug
model:
type: string
capability:
type: string
mode:
type: string
status:
type: string
enum:
- queued
- processing
- succeeded
- failed
- timeout
- cancelled
output:
type: object
nullable: true
error:
type: object
nullable: true
properties:
type:
type: string
description: Machine-readable error code
code:
type: number
description: HTTP status
message:
type: string
billing:
type: object
nullable: true
properties:
amount:
type: string
currency:
type: string
enum:
- usd
created_at:
type: string
format: date-time
started_at:
type: string
format: date-time
nullable: true
completed_at:
type: string
format: date-time
nullable: true
elapsed_ms:
type: number
nullable: true
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: Key sk-... (native REST) or Bearer sk-... (vendor SDKs)
````