API ReferenceVideo Generation

Retake video section

Edit a specific section of a video by replacing audio, video, or both using AI generation.

The edited section is defined by the start_time and duration parameters.

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 headers

x-request-idstring
Unique request identifier for tracking and debugging
Content-Typestring
The MIME type of the video file
Content-Lengthinteger
The size of the video file in bytes

Response

Video edited successfully

Errors

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error
504
Gateway Timeout Error