---
title: "Retake video section"
method: POST
path: "/v1/retake"
tags: ["videoGeneration"]
---

# Retake video section

`POST /v1/retake`

Re-generate a section of an existing video by replacing either its audio, its video, or both. Iterate on part of a generation without starting over — the rest of the video is preserved. The edited section is defined by the `start_time` and `duration` parameters.

Returns the generated video directly in the response. For an asynchronous version that returns a job to poll, see [v2/retake](/api-documentation/api-reference/async-video-generation/submit-retake).

Billed per second of the input video. See [Pricing](/pricing).

## Headers

- `Authorization` string, required

## Request body

- EditVideoRequest
  - `video_uri` string, required — Input video for editing. See [Input Formats](/input-formats#video-input) for supported formats and codecs. - Maximum resolution: 3840x2160 (4K) - Minimum frame count: 73 (around 3 seconds at 24fps)
  - `prompt` string — Describing what needs to happen in the generated video in a section defined by `start_time` and `duration`.
  - `start_time` number, double, required — 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.
  - `duration` number, double, required — 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.
  - `mode` 'replace_audio' | 'replace_video' | '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.
  - `resolution` '1920x1080' | '1080x1920' — 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.
  - `model` 'ltx-2-3-pro' — Model to use for video generation.

## Response `200`

Video edited successfully

## Other responses

- `400` — The request is invalid or malformed
- `401` — Authentication failed
- `422` — Content rejected by safety filters
- `429` — Concurrency or queue limit exceeded
- `500` — An unexpected error occurred
- `503` — Service temporarily unavailable
- `504` — Request timeout

---

[API](https://skmtc.dev/ltx/apis/api-reference.md) · [All operations](https://skmtc.dev/ltx/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ltx/api-reference/revisions/6ad7c87b252c/schema)