API ReferenceAsync Video Generation

Retake video section

Beta
Re-generate a section of an existing video by replacing its audio, video, or both. Select a time range and mode to iterate on part of a generation without starting over — the rest of the video is preserved. Responds immediately with the job `id` and `created_at` timestamp. Poll `GET /v2/retake/{id}` until the status is `completed`, then download from `result.video_url`.

Authentication

AuthorizationBearer
API key authentication

Request

This endpoint expects an object.
video_uristringRequired

Input video for editing. See Input Formats for supported formats and codecs.

  • Maximum resolution: 3840x2160 (4K)
  • Minimum frame count: 73 (around 3 seconds at 24fps)
start_timedoubleRequired>=0

Start time in seconds, defines the section to be edited in the input video.

The section defined by start_time and duration should be within the duration of the input video. If the section extends beyond the duration of the video, it will be clamped to the video duration.

durationdoubleRequired>=2

Duration in seconds, defines the duration of the section to be edited in the input video. Must be at least 2 seconds.

The section defined by start_time and duration should be within the duration of the input video. If the section extends beyond the duration of the video, it will be clamped to the video duration.

promptstringOptional<=5000 characters

Describing what needs to happen in the generated video in a section defined by start_time and duration.

modeenumOptionalDefaults to replace_audio_and_video

Can be any of the following:

  • replace_audio - Replace only the audio track
  • replace_video - Replace only the video track
  • replace_audio_and_video - Replace both audio and video tracks

The default value is replace_audio_and_video if not specified.

Allowed values:
resolutionenumOptional

The resolution of the generated video in WIDTHxHEIGHT format. When omitted, the resolution is automatically determined based on the input video orientation — portrait videos produce 1080x1920 output, landscape videos produce 1920x1080 output.

Allowed values:
modelenumOptionalDefaults to ltx-2-3-pro
Model to use for video generation.
Allowed values:

Response

Job submitted successfully
idstring
Unique job identifier. Use this to poll for status.
created_atdatetime
ISO 8601 timestamp of when the job was created.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error