Skip to main content
POST
Edit a video
Send a source video and an edit prompt to FLUX Video Edit. This is a FLUX Tools endpoint, separate from /v1/flux-3-video; do not send a mode.

Retrieve the edited clip

The submission returns an id and a polling_url. Poll that URL while status is Pending, Reasoning, or Generating. Polling does not require an API key. When status is Ready, download the video from result.sample. Do not send the API key to the video download URL. Stop on Request Moderated, Content Moderated, Error, or Task not found. Requests to use the clip as a reference for a new video or to extend it fail with HTTP 422, status: "Error", and an explanation in details.error. Use video continuation for extension. A polling HTTP 503 with Retry-After means to wait and retry the same URL, not submit another generation. Download completed results promptly; their signed URLs expire after about one hour.

Limits and pricing

Input limits, output behavior and pricing are on the FLUX Video Edit page, with a quick start that submits and polls.

Authorizations

x-key
string
header
required

Body

application/json
video
string
required

The video to edit, as an HTTP(S) URL or a base64-encoded MP4. Up to 15 seconds and 50 MiB, at least 160 pixels on each side and at least 17 frames after normalization to 24 fps.

prompt
string
required

Edit instruction. Surrounding whitespace is removed before validation.

Required string length: 1 - 4096
safety_tolerance
integer
default:2

Input and output moderation tolerance; 0 is strictest. Sexual content is capped at level 3 and hate content at level 2 regardless of this value.

Required range: 0 <= x <= 4

Response

Task accepted. Poll the returned polling_url until Ready, then download result.sample.

id
string
required
polling_url
string
required
cost
number | null

Cost in credits for this request.

input_mp
number | null

Input megapixels.

output_mp
number | null

Output megapixels.