Skip to main content
POST
Upscale a video with FLUX 3 Video Upscale

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
video
string
required

The video to upscale (up to 20 seconds and 2560x1440, MP4/MOV/WebM, ≤100MB). A public video URL or an uploaded-file URL from POST /v1/uploads (videos are passed by URL, not inlined).

mode
enum<string>
default:precise

precise keeps the source as it is; creative adds fine detail (faces and products can change) and costs more.

Available options:
precise,
creative
prompt
string

Optional: what the clip shows, to steer the detail creative mode adds (up to 1000 characters).

upscale_factor
enum<number>
default:2

How many times larger the output frame is. 720p at 3 is 4K (3840x2160).

Available options:
1.5,
2,
2.5,
3

Response

Job accepted.

credits
integer

Total price of this job (seconds x the model's per-second rate).

id
string

Opaque job id (mtn_...) — use it to poll status.

message
string
model
string
seconds
integer

Billed duration — the reference video's length, rounded up.

status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout