---
title: "Edit a video with FLUX 3."
method: POST
path: "/v1/flux-tools/video-edit-v1"
tags: ["Models"]
---

# Edit a video with FLUX 3.

`POST /v1/flux-tools/video-edit-v1`

Submits a video edit task: the supplied clip is transformed according to the edit instruction. Duration, resolution, aspect ratio, and audio follow the source clip; inference controls are pinned server-side.

## Request body

- Flux3VideoVE2VNamedInputs — 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.
  - `user` string, nullable — Opaque identifier for the end user supplied by the calling platform.
  - `video` string, required — The video to edit, an http(s) URL or base64-encoded mp4.
  - `prompt` string, required — Edit instruction, stripped of surrounding whitespace.
  - `safety_tolerance` integer — 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.

## Response `200`

Successful Response

- union
  - AsyncResponse
    - `id` string, required
    - `polling_url` string, required
    - `cost` number, nullable — Cost in credits for this request
    - `input_mp` number, nullable — Input megapixels (2 decimal places)
    - `output_mp` number, nullable — Output megapixels (2 decimal places)
  - AsyncWebhookResponse
    - `id` string, required
    - `status` string, required
    - `webhook_url` string, required
    - `cost` number, nullable — Cost in credits for this request
    - `input_mp` number, nullable — Input megapixels (2 decimal places)
    - `output_mp` number, nullable — Output megapixels (2 decimal places)

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-15** `55a676c69c9d` — 1 info
  - added the new optional request property `user`
- **2026-09-11** `bfcfd689618a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bfl/apis/bfl-api/changes/v1/flux-tools/video-edit-v1/post.md)

---

[API](https://skmtc.dev/bfl/apis/bfl-api.md) · [All operations](https://skmtc.dev/bfl/apis/bfl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bfl/apis/bfl-api/revisions/63d11365e56b?raw)
