Перейти к содержимому

Ltx 2.3 Quality · Reference Video to Video · LoRA

Интеграция

ID модели ltx-2.3-quality/reference-video-to-video/lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video/lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Файлы, как в примере: 0,304 $ 304 API-кредита · ≈ 32,40 ₽ ваши файлы измеряются перед запуском Запустить на этой странице

Получить API-ключ
Lightricks Видео в видео Встроенное аудио

Генерация по референсному видео, как в базовой версии, с применением до 3 пользовательских LoRA

Lightricks · Видео

Здесь появится ваш первый результат

Составьте запрос ниже и выполните его с помощью API-ключа. Результаты копируются в наше хранилище и хранятся навсегда или 7 дней бесплатно.

Сформировать запрос

Элементы управления сгенерированы из схемы модели. Код и цена обновляются при изменении параметров.

•обязательно

Промпт, используемый для управления генерацией.

•обязательно video_url
Перетащите файл или

URL эталонного видео, используемого для задания движения и структуры.

resolution по умолчанию auto

Размеры выходного видео, которые также влияют на стабильную длительность: меньшие размеры позволяют использовать больше кадров, а большие уменьшают максимум. Встроенная оценка управления сохраняет размер близким к официальному рабочему процессу управления; прямое управление через `skip_control_preprocess` и `control_video_url` вместо этого учитывает явно заданные размеры с выравниванием по 64px. В режиме прямого управления `auto` наследует размеры и соотношение сторон исходника в пределах ограничений LTX.

по умолчанию 121

Количество выходных кадров с учётом бюджета стабильности IC-LoRA, рассчитываемого как разрешение, умноженное на количество кадров. Ответ 422 означает превышение бюджета: уменьшите разрешение или `num_frames`. Бюджет допускает примерно 150 кадров при размерах класса 720p и больше при меньших размерах.

•обязательно

Дополнения LoRA для LTX-2.3, каждое размером не более 3 GB; разрешено не более 3 элементов. Загрузка выполняется только после получения каждого пути загрузчиком реестра, защищённым от SSRF.

Расширенные negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
по умолчанию color distortion, ove...

Негативный промпт, указывающий, чего следует избегать при генерации.

Перетащите файл или

Необязательное предварительно вычисленное управляющее видео, используемое вместо встроенной оценки управления, если оно передано вместе с `skip_control_preprocess`. После изменения размера для соответствия выходным размерам и количеству кадров оно становится прямым управляющим сигналом. Например, видео может содержать уже отрендеренную композицию глубины, контуров или позы.

image_url
Перетащите файл или

Необязательная стилистическая привязка изображения или идентичность персонажа в качестве ключевого кадра первого кадра.

Перетащите файл или

Необязательная привязка внешнего вида изображения около середины клипа, дополняющая начальный ключевой кадр `image_url`. Она помогает внешнему виду следовать движению камеры, а не смещаться; требуется `image_url`.

end_image_url
Перетащите файл или

Необязательная привязка внешнего вида изображения в последнем кадре клипа. Полезна, если движение камеры заканчивается в месте, отличном от начального изображения; требуется `image_url`.

video_quality по умолчанию high

Предустановка качества, применяемая к выходному видео.

video_write_mode по умолчанию balanced

Режим записи результирующего видео.

по умолчанию 0.6

Свобода изменения движения и структуры исходного видео задаётся этой силой обусловливания: меньшие значения допускают больше изменений.

по умолчанию 1

Управление устранением шума при сэмплировании «видео-видео» по эталонному видео; эффект зависит от `preserve_original_video`. Если режим отключён, настройка лишь сокращает расписание устранения шума; если включён — управляет преобразованием исходных пикселей: значение 1.0 регенерирует всё, а меньшие значения сохраняют больше (например, 0.5 сохраняет около 50%).

по умолчанию 24

Частота кадров выходного видео, измеряемая в кадрах в секунду.

по умолчанию 15

Задайте количество шагов вывода — не более 30; без изменения используется 15.

по умолчанию 1

Настройте classifier-free guidance с помощью этой шкалы; её значение по умолчанию рассчитано на высокое качество и быструю генерацию.

Сид, обеспечивающий воспроизводимость генерации. Значение None выбирает сид случайным образом.

POST /run/ltx-2.3-quality/reference-video-to-video/lora?wait=20 стоимость → 0,304 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video/lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О Ltx 2.3 Quality · Reference Video to Video · LoRA

Генерирует видео по обязательному `prompt` и референсному `video_url` для движения и структуры, а также требует `loras` — до 3 файлов LoRA размером не более 3 GB каждый. Необязательные изображения первого, среднего и последнего ключевых кадров (`image_url`, `mid_image_url`, `end_image_url`) фиксируют внешний вид. `video_strength` и `strength` принимают значения от 0 до 1, а `num_frames` — от 9 до 481.

Параметры

Передавайте либо каноническое имя, либо исходное имя, но не оба. Канонические имена

ИмяТип По умолчаниюДопустимые значения Описание
promptобязательно
Типstring
Промпт, используемый для управления генерацией.
video_urlобязательно video
Типurl · video
URL эталонного видео, используемого для задания движения и структуры.
control_video_urlнеобязательно
Типurl · video
Необязательное предварительно вычисленное управляющее видео, используемое вместо встроенной оценки управления, если оно передано вместе с `skip_control_preprocess`. После изменения размера для соответствия выходным размерам и количеству кадров оно становится прямым управляющим сигналом. Например, видео может содержать уже отрендеренную композицию глубины, контуров или позы.
skip_control_preprocessнеобязательно
Типboolean
По умолчаниюfalse
Режим прямого управления с использованием `control_video_url` вместо внутренней оценки глубины, контуров или позы; без этого URL настройка игнорируется. В этом режиме размеры выхода учитывают явно заданные размеры с выравниванием по 64 для согласования RGB-видео и управляющего видео, а `auto` использует размеры и соотношение сторон исходника в пределах ограничений LTX.
preserve_original_videoнеобязательно
Типboolean
По умолчаниюfalse
Режим сохранения исходного видео, доступный только вместе с `skip_control_preprocess`, `video_url` и `control_video_url`. По умолчанию отключён и сохраняет стандартную обработку управления; при включении генерация начинается с `video_url`, сохраняя структурное наведение из `control_video_url`. Устранение шума через `strength` задаёт объём сохраняемого содержимого: меньшие значения сохраняют больше исходных пикселей.
image_urlнеобязательно image
Типurl · image
Необязательная стилистическая привязка изображения или идентичность персонажа в качестве ключевого кадра первого кадра.
mid_image_urlнеобязательно
Типurl · image
Необязательная привязка внешнего вида изображения около середины клипа, дополняющая начальный ключевой кадр `image_url`. Она помогает внешнему виду следовать движению камеры, а не смещаться; требуется `image_url`.
end_image_urlнеобязательно end_image
Типurl · image
Необязательная привязка внешнего вида изображения в последнем кадре клипа. Полезна, если движение камеры заканчивается в месте, отличном от начального изображения; требуется `image_url`.
video_strengthнеобязательно
Типnumber
По умолчанию0.6
0 – 1
Свобода изменения движения и структуры исходного видео задаётся этой силой обусловливания: меньшие значения допускают больше изменений.
strengthнеобязательно
Типnumber
По умолчанию1
0 – 1
Управление устранением шума при сэмплировании «видео-видео» по эталонному видео; эффект зависит от `preserve_original_video`. Если режим отключён, настройка лишь сокращает расписание устранения шума; если включён — управляет преобразованием исходных пикселей: значение 1.0 регенерирует всё, а меньшие значения сохраняют больше (например, 0.5 сохраняет около 50%).
num_framesнеобязательно
Типinteger
По умолчанию121
9 – 481
Количество выходных кадров с учётом бюджета стабильности IC-LoRA, рассчитываемого как разрешение, умноженное на количество кадров. Ответ 422 означает превышение бюджета: уменьшите разрешение или `num_frames`. Бюджет допускает примерно 150 кадров при размерах класса 720p и больше при меньших размерах.
resolutionнеобязательно
Типobject
По умолчаниюauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Размеры выходного видео, которые также влияют на стабильную длительность: меньшие размеры позволяют использовать больше кадров, а большие уменьшают максимум. Встроенная оценка управления сохраняет размер близким к официальному рабочему процессу управления; прямое управление через `skip_control_preprocess` и `control_video_url` вместо этого учитывает явно заданные размеры с выравниванием по 64px. В режиме прямого управления `auto` наследует размеры и соотношение сторон исходника в пределах ограничений LTX.
frames_per_secondнеобязательно
Типnumber
По умолчанию24
1 – 60
Частота кадров выходного видео, измеряемая в кадрах в секунду.
num_inference_stepsнеобязательно
Типinteger
По умолчанию15
8 – 30
Задайте количество шагов вывода — не более 30; без изменения используется 15.
guidance_scaleнеобязательно
Типnumber
По умолчанию1
1 – 20
Настройте classifier-free guidance с помощью этой шкалы; её значение по умолчанию рассчитано на высокое качество и быструю генерацию.
generate_audioнеобязательно
Типboolean
По умолчаниюtrue
Переключатель аудиодорожки для возвращаемого MP4: в выключенном состоянии создаётся файл только с видео, во включённом добавляется аудио.
negative_promptнеобязательно
Типstring
По умолчаниюcolor distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards
Негативный промпт, указывающий, чего следует избегать при генерации.
seedнеобязательно
Типinteger | null
Сид, обеспечивающий воспроизводимость генерации. Значение None выбирает сид случайным образом.
enable_prompt_expansionнеобязательно
Типboolean
По умолчаниюtrue
Определяет, включено ли расширение промпта.
enable_safety_checkerнеобязательно
Типboolean
По умолчаниюtrue
Определяет, включена ли проверка безопасности.
video_qualityнеобязательно
Типenum
По умолчаниюhigh
lowmediumhighmaximum
Предустановка качества, применяемая к выходному видео.
video_write_modeнеобязательно
Типenum
По умолчаниюbalanced
fastbalancedsmall
Режим записи результирующего видео.
lorasобязательно
Типobject[]
≤ 3 элемента
Дополнения LoRA для LTX-2.3, каждое размером не более 3 GB; разрешено не более 3 элементов. Загрузка выполняется только после получения каждого пути загрузчиком реестра, защищённым от SSRF.
loras[].pathобязательно
Типstring
≤ 2048 characters
Прямой HTTP(S) URL файла LoRA .safetensors размером не более 3 GB. Перед загрузкой файл извлекается загрузчиком, защищённым от SSRF.
loras[].scaleнеобязательно
Типnumber
По умолчанию1
0 – 2
Влияние LoRA на сгенерированное видео увеличивается с ростом этой силы в диапазоне 0.0–2.0.
loras[].transformerнеобязательно
Типenum
По умолчаниюboth
highlowboth
Флаг выбора трансформера: 'both' подходит почти всем пользователям LTX-2.3, поскольку модель содержит только один трансформер. Флаг предназначен для поддержки будущих архитектур с несколькими трансформерами.
обязательно Каноническое имя, также принимается

Параметры файлов принимают общедоступный https:// URL, data: URI размером до 10 MB или file_url загруженного файла. Файлы

Результат

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/reference-video-to-video/lora",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 304,
    "usd": "0.304",
    "charged": 304,
    "refunded": 0
  },
  "input": {
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
video
object {url, content_type, file_name, file_size}Видео, созданное моделью.
seed
integerФактически использованный при генерации seed.
prompt
stringПромпт генерации, включая расширение, применённое перед использованием.

Другие модели: Видео в видео

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. Все модели и руководства: https://doitong.com/developers/llms.txt