Edit a video

curl --request POST \
  --url https://api.bfl.ai/v1/flux-tools/video-edit-v1 \
  --header "x-key: $BFL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "video": "https://cdn.sanity.io/files/2gpum2i6/production/f1654af36e7694775939b1aa8a2bb0419ff819ea.mp4",
  "prompt": "Remove the orange bucket."
}'

{
  "id": "<string>",
  "polling_url": "<string>",
  "cost": 123,
  "input_mp": 123,
  "output_mp": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

flux-tools

video-edit-v1

curl --request POST \
  --url https://api.bfl.ai/v1/flux-tools/video-edit-v1 \
  --header "x-key: $BFL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "video": "https://cdn.sanity.io/files/2gpum2i6/production/f1654af36e7694775939b1aa8a2bb0419ff819ea.mp4",
  "prompt": "Remove the orange bucket."
}'

{
  "id": "<string>",
  "polling_url": "<string>",
  "cost": 123,
  "input_mp": 123,
  "output_mp": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

curl --request POST \
  --url https://api.bfl.ai/v1/flux-tools/video-edit-v1 \
  --header "x-key: $BFL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "video": "https://cdn.sanity.io/files/2gpum2i6/production/f1654af36e7694775939b1aa8a2bb0419ff819ea.mp4",
  "prompt": "Remove the orange bucket."
}'

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 edit on a dedicated route: the clip and the instruction.

The public /flux-tools/video-edit-v1 body. The route pins the recipe, so the body has no mode and no version to pick, and every serving control -- duration, resolution, aspect ratio, audio, steps, guidance, seed -- stays server-pinned.

video

string

required

The video to edit, an http(s) URL or base64-encoded mp4.

prompt

string

required

Edit instruction, stripped of surrounding whitespace.

Required string length: 1 - 4096

user

string | null

Opaque identifier for the end user supplied by the calling platform.

Required string length: 1 - 256

safety_tolerance

integer

default:2

Tolerance level for input and output harm moderation. Between 0 and 4, with 0 the strictest. Sexual content is limited to level 3 and hate content to level 2 regardless of the requested tolerance.

Required range: 0 <= x <= 4

Response

Successful Response

AsyncResponse
AsyncWebhookResponse

string

required

polling_url

string

required

cost

number | null

Cost in credits for this request

input_mp

number | null

Input megapixels (2 decimal places)

output_mp

number | null

Output megapixels (2 decimal places)

General

FLUX 3 Models

FLUX.2 Models

FLUX.2 Klein Models

FLUX Tools

Legacy Models

Fine-tuning

Licensing

Retrieve the edited clip

Limits and pricing

Authorizations

Body

Response

​Retrieve the edited clip

​Limits and pricing

Authorizations

Body

Response

Retrieve the edited clip

Limits and pricing