Создаёт видео со звуком по текстовому описанию, из картинки или под загруженное аудио — в версиях Fast (до 20 секунд и 4K) и Pro. Цена зависит от разрешения: Fast — 720p 15 ₽/сек., 1080p 22 ₽/сек., 1440p 32 ₽/сек., 4K 50 ₽/сек.; Pro — 720p 20 ₽/сек., 1080p 28 ₽/сек.; видео по звуку — 22 ₽ (Fast) или 28 ₽ (Pro) за секунду аудио.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
LTX 2.5 - видеомодель, которая снимает ролик сразу со звуком. Ей можно дать текстовое описание сцены, картинку для первого кадра или готовую звуковую дорожку - тогда видео строится под этот звук: под музыку, голос или шумы. Подходит для коротких роликов в соцсети, рекламных заставок, оживления иллюстраций и клипов под готовый трек.
Основные сценарии:
generation_type: "text_to_video".generation_type: "image_to_video", картинка становится первым кадром, по желанию можно задать и последний.generation_type: "audio_to_video", ролик длится столько же, сколько аудио, и движется в его ритме. Первый кадр можно задать картинкой.У каждого сценария две версии модели: fast - быстрее и дешевле, ролики до 20 секунд и до 4K; pro - выше качество, ролики до 10 секунд и до 1080p.
Каждый вызов создаёт асинхронную операцию. После запуска сохраните id и проверяйте статус отдельным запросом.
POST /api/v1/operationsAuthorization: Bearer brth_...id операции и стартовый статус queued.Режим задаёт параметр generation_type:
text_to_video - видео из текста (prompt_text_image, aspect_ratio_text);image_to_video - видео из изображения (prompt_text_image, image_url, по желанию end_image_url);audio_to_video - видео по звуку (audio_url и либо prompt_audio, либо картинка первого кадра audio_image_url).В режимах text_to_video и image_to_video длительность лежит в одном из трёх полей - в зависимости от модели, разрешения и частоты кадров:
| Модель | Разрешение и FPS | Поле | Значения |
|---|---|---|---|
pro | любые | duration_pro | 6, 8 или 10 |
fast | 1440p или 2160p, либо FPS 48 или 50 | duration_fast_short | 6, 8 или 10 |
fast | 720p или 1080p и FPS 24 или 25 | duration_fast_long | 6, 8, 10, 12, 14, 16, 18 или 20 |
Поле, которое не подходит к выбранным параметрам, не учитывается: будет взята длительность по умолчанию, 6 секунд. Передавайте чётные значения из таблицы.
В режиме audio_to_video длительность не передаётся: ролик равен длине аудио.
{
"tool": "ltx-2-5",
"input": {
"...": "..."
}
}
tool - slug нейросети, всегда "ltx-2-5".input - параметры запуска. Все поля передаются прямо внутри этого объекта, без дополнительной вложенности.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
generation_type | enum | Да | Режим: image_to_video, text_to_video или audio_to_video. Если поле не передать, используется image_to_video - тогда обязательны prompt_text_image и image_url. |
model_tier | enum | Да | Версия модели во всех режимах: fast - быстрее и дешевле, до 20 секунд и до 4K; pro - выше качество, до 10 секунд и до 1080p. Если не указать - fast. |
prompt_text_image | string | Да, для text_to_video и image_to_video | Что происходит в ролике: сцена, действие, движение камеры, звуки и реплики. От 3 до 5000 символов. |
image_url | string (url) | Да, для image_to_video | Первый кадр ролика. Один файл: jpg, jpeg, png или webp. |
use_end_image | boolean | Нет | Задать последний кадр в режиме image_to_video. По умолчанию false. |
end_image_url | string (url) | Да, если use_end_image: true | Последний кадр ролика: модель снимет переход от первого кадра к нему. Только в image_to_video и только вместе с use_end_image: true, иначе не учитывается. Форматы те же. |
audio_url | string (url) | Да, для audio_to_video | Звуковая дорожка, под которую снимается ролик: от 2 до 20 секунд, в pro - до 10 секунд. Форматы: mp3, wav, m4a, aac, flac, ogg, opus. От длины аудио зависят цена и длина ролика. |
use_audio_image | boolean | Нет | Задать картинку первого кадра в режиме audio_to_video. По умолчанию false. |
prompt_audio | string | Да, для audio_to_video без картинки | Что происходит в кадре под этот звук. От 3 до 5000 символов. Учитывается, только если use_audio_image не true. |
audio_image_url | string (url) | Да, если use_audio_image: true | Первый кадр для режима audio_to_video, например портрет, который будет петь или говорить. Форматы: jpg, jpeg, png или webp. |
prompt_audio_image | string | Нет | Подсказка к картинке в audio_to_video при use_audio_image: true: мимика, движение, что меняется в сцене. До 5000 символов, можно не передавать. |
resolution | enum | Да | Разрешение для text_to_video и image_to_video: 720p, 1080p, 1440p или 2160p (4K). 1440p и 2160p - только в fast. Если не указать - 1080p. |
fps | enum | Да | Кадров в секунду для text_to_video и image_to_video, строкой: "24", "25", "48" или "50". "48" - только в fast. Если не указать - "25". На цену не влияет, но меняет доступную длительность (см. таблицу выше). |
aspect_ratio_text | enum | Да | Соотношение сторон в text_to_video: 16:9 или 9:16. Если не указать - 16:9. |
aspect_ratio_image | enum | Да | Соотношение сторон в image_to_video: auto (по картинке), 16:9 или 9:16. Если не указать - auto. |
aspect_ratio_audio | enum | Да | Соотношение сторон в audio_to_video: auto (по картинке первого кадра, без неё - 16:9), 16:9 или 9:16. Если не указать - auto. |
duration_pro | number | Да, для pro | Длительность в секундах для model_tier: "pro" в text_to_video и image_to_video: 6, 8 или 10. Если не указать - 6. |
duration_fast_short | number | Да, для fast в 1440p, 4K или 48/50 FPS | Длительность для fast, если разрешение 1440p или 2160p либо FPS 48 или 50: 6, 8 или 10. Если не указать - 6. |
duration_fast_long | number | Да, для fast в 720p/1080p и 24/25 FPS | Длительность для fast в 720p или 1080p при 24 или 25 FPS: от 6 до 20 с шагом 2. Если не указать - 6. |
camera_motion | enum | Да | Движение камеры в text_to_video и image_to_video: none - как описано в задании, dolly_in - наезд, dolly_out - отъезд, dolly_left и dolly_right - сдвиг влево и вправо, jib_up и jib_down - подъём и опускание, static - неподвижная камера, focus_shift - перевод фокуса. Если не указать - none. |
generate_audio | boolean | Нет | Сгенерировать звук к ролику в text_to_video и image_to_video. По умолчанию true, для немого ролика передайте false. На цену не влияет. |
Ссылки на файлы передавайте как внешние http/https URL с подходящим расширением. Файл должен открываться без авторизации.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "ltx-2-5",
"input": {
"generation_type": "text_to_video",
"model_tier": "fast",
"prompt_text_image": "Уютная пекарня рано утром, пекарь достаёт из печи противень с круассанами, от выпечки поднимается пар, слышно потрескивание печи",
"resolution": "1080p",
"fps": "25",
"aspect_ratio_text": "16:9",
"duration_fast_long": 12,
"camera_motion": "dolly_out",
"generate_audio": true
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ltx-2-5',
input: {
generation_type: 'text_to_video',
model_tier: 'fast',
prompt_text_image: 'Уютная пекарня рано утром, пекарь достаёт из печи противень с круассанами, от выпечки поднимается пар, слышно потрескивание печи',
resolution: '1080p',
fps: '25',
aspect_ratio_text: '16:9',
duration_fast_long: 12,
camera_motion: 'dolly_out',
generate_audio: true,
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'ltx-2-5',
'input': {
'generation_type': 'text_to_video',
'model_tier': 'fast',
'prompt_text_image': 'Уютная пекарня рано утром, пекарь достаёт из печи противень с круассанами, от выпечки поднимается пар, слышно потрескивание печи',
'resolution': '1080p',
'fps': '25',
'aspect_ratio_text': '16:9',
'duration_fast_long': 12,
'camera_motion': 'dolly_out',
'generate_audio': True,
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "ltx-2-5",
"input": {
"generation_type": "text_to_video",
"model_tier": "fast",
"prompt_text_image": "Капли дождя медленно стекают по стеклу ночного такси, за окном размытые огни города",
"resolution": "2160p",
"fps": "25",
"aspect_ratio_text": "9:16",
"duration_fast_short": 8,
"camera_motion": "focus_shift",
"generate_audio": false
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ltx-2-5',
input: {
generation_type: 'text_to_video',
model_tier: 'fast',
prompt_text_image: 'Капли дождя медленно стекают по стеклу ночного такси, за окном размытые огни города',
resolution: '2160p',
fps: '25',
aspect_ratio_text: '9:16',
duration_fast_short: 8,
camera_motion: 'focus_shift',
generate_audio: false,
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'ltx-2-5',
'input': {
'generation_type': 'text_to_video',
'model_tier': 'fast',
'prompt_text_image': 'Капли дождя медленно стекают по стеклу ночного такси, за окном размытые огни города',
'resolution': '2160p',
'fps': '25',
'aspect_ratio_text': '9:16',
'duration_fast_short': 8,
'camera_motion': 'focus_shift',
'generate_audio': False,
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "ltx-2-5",
"input": {
"generation_type": "image_to_video",
"model_tier": "pro",
"prompt_text_image": "Рыжий кот на подоконнике поворачивает голову к окну и щурится от солнца, шевелится занавеска",
"image_url": "https://cdn.example.com/source-image-1.jpg",
"resolution": "1080p",
"fps": "25",
"aspect_ratio_image": "auto",
"duration_pro": 8,
"camera_motion": "dolly_in",
"generate_audio": true
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ltx-2-5',
input: {
generation_type: 'image_to_video',
model_tier: 'pro',
prompt_text_image: 'Рыжий кот на подоконнике поворачивает голову к окну и щурится от солнца, шевелится занавеска',
image_url: 'https://cdn.example.com/source-image-1.jpg',
resolution: '1080p',
fps: '25',
aspect_ratio_image: 'auto',
duration_pro: 8,
camera_motion: 'dolly_in',
generate_audio: true,
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'ltx-2-5',
'input': {
'generation_type': 'image_to_video',
'model_tier': 'pro',
'prompt_text_image': 'Рыжий кот на подоконнике поворачивает голову к окну и щурится от солнца, шевелится занавеска',
'image_url': 'https://cdn.example.com/source-image-1.jpg',
'resolution': '1080p',
'fps': '25',
'aspect_ratio_image': 'auto',
'duration_pro': 8,
'camera_motion': 'dolly_in',
'generate_audio': True,
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "ltx-2-5",
"input": {
"generation_type": "image_to_video",
"model_tier": "fast",
"prompt_text_image": "Бутон розы плавно раскрывается в полный цветок, мягкий утренний свет",
"image_url": "https://cdn.example.com/source-image-1.jpg",
"use_end_image": true,
"end_image_url": "https://cdn.example.com/source-image-2.png",
"resolution": "720p",
"fps": "24",
"aspect_ratio_image": "auto",
"duration_fast_long": 6,
"generate_audio": false
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ltx-2-5',
input: {
generation_type: 'image_to_video',
model_tier: 'fast',
prompt_text_image: 'Бутон розы плавно раскрывается в полный цветок, мягкий утренний свет',
image_url: 'https://cdn.example.com/source-image-1.jpg',
use_end_image: true,
end_image_url: 'https://cdn.example.com/source-image-2.png',
resolution: '720p',
fps: '24',
aspect_ratio_image: 'auto',
duration_fast_long: 6,
generate_audio: false,
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'ltx-2-5',
'input': {
'generation_type': 'image_to_video',
'model_tier': 'fast',
'prompt_text_image': 'Бутон розы плавно раскрывается в полный цветок, мягкий утренний свет',
'image_url': 'https://cdn.example.com/source-image-1.jpg',
'use_end_image': True,
'end_image_url': 'https://cdn.example.com/source-image-2.png',
'resolution': '720p',
'fps': '24',
'aspect_ratio_image': 'auto',
'duration_fast_long': 6,
'generate_audio': False,
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "ltx-2-5",
"input": {
"generation_type": "audio_to_video",
"model_tier": "fast",
"prompt_audio": "Уличный барабанщик играет на пластиковых вёдрах на летней площади, вокруг собираются прохожие",
"audio_url": "https://cdn.example.com/source-audio-1.mp3",
"aspect_ratio_audio": "16:9"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ltx-2-5',
input: {
generation_type: 'audio_to_video',
model_tier: 'fast',
prompt_audio: 'Уличный барабанщик играет на пластиковых вёдрах на летней площади, вокруг собираются прохожие',
audio_url: 'https://cdn.example.com/source-audio-1.mp3',
aspect_ratio_audio: '16:9',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'ltx-2-5',
'input': {
'generation_type': 'audio_to_video',
'model_tier': 'fast',
'prompt_audio': 'Уличный барабанщик играет на пластиковых вёдрах на летней площади, вокруг собираются прохожие',
'audio_url': 'https://cdn.example.com/source-audio-1.mp3',
'aspect_ratio_audio': '16:9',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "ltx-2-5",
"input": {
"generation_type": "audio_to_video",
"model_tier": "pro",
"use_audio_image": true,
"audio_image_url": "https://cdn.example.com/source-image-1.jpg",
"prompt_audio_image": "Девушка поёт в микрофон, улыбается и слегка покачивает головой в ритм",
"audio_url": "https://cdn.example.com/source-audio-1.mp3",
"aspect_ratio_audio": "auto"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ltx-2-5',
input: {
generation_type: 'audio_to_video',
model_tier: 'pro',
use_audio_image: true,
audio_image_url: 'https://cdn.example.com/source-image-1.jpg',
prompt_audio_image: 'Девушка поёт в микрофон, улыбается и слегка покачивает головой в ритм',
audio_url: 'https://cdn.example.com/source-audio-1.mp3',
aspect_ratio_audio: 'auto',
},
}),
})
const data = await response.json()
import requests
response = requests.post(
'https://bratuha.ru/api/v1/operations',
headers={
'Authorization': 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
json={
'tool': 'ltx-2-5',
'input': {
'generation_type': 'audio_to_video',
'model_tier': 'pro',
'use_audio_image': True,
'audio_image_url': 'https://cdn.example.com/source-image-1.jpg',
'prompt_audio_image': 'Девушка поёт в микрофон, улыбается и слегка покачивает головой в ритм',
'audio_url': 'https://cdn.example.com/source-audio-1.mp3',
'aspect_ratio_audio': 'auto',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "ltx-2-5",
"cost": 264,
"balance_after": 736,
"created_at": "2026-11-11T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "ltx-2-5",
"cost": 264,
"created_at": "2026-11-11T12:00:00Z",
"completed_at": "2026-11-11T12:02:10Z",
"result": {
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/ltx-2-5/video-1.mp4"
]
},
"error_message": null
}
Если модель не смогла выполнить задачу, операция завершается со статусом failed, в result приходит null, а причина - в error_message. Списанная сумма возвращается на баланс.
{
"id": "op_uuid-123",
"status": "failed",
"tool": "ltx-2-5",
"cost": 132,
"created_at": "2026-11-11T12:00:00Z",
"completed_at": "2026-11-11T12:00:09Z",
"result": null,
"error_message": "Ваш запрос не прошел модерацию"
}
Сохраните id из ответа на создание и проверяйте операцию по нему:
GET /api/v1/operations/{id}
curl -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
async function waitForResult(id: string) {
while (true) {
const response = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
headers: { Authorization: 'Bearer brth_ваш_ключ' },
})
const operation = await response.json()
if (operation.status === 'completed' || operation.status === 'failed') {
return operation
}
await new Promise((resolve) => setTimeout(resolve, 5000))
}
}
Ролик обычно готов за одну-несколько минут: длинные видео, 1440p и 4K делаются дольше. Одну операцию можно опрашивать не чаще раза в секунду, разумный интервал - 5-10 секунд.
После завершения в result приходит одно видео:
{
"type": "video",
"urls": [
"https://storage.bratuha.ru/results/ltx-2-5/video-1.mp4"
]
}
type - всегда "video".urls - массив с одной ссылкой на MP4.generate_audio: true.Цена считается за секунду. Ставка зависит от модели и разрешения. FPS, движение камеры и звук на цену не влияют.
Видео из текста и из изображения, оплачивается выбранная длительность:
| Модель | 720p | 1080p | 1440p | 2160p (4K) |
|---|---|---|---|---|
fast | 15 ₽/сек. | 22 ₽/сек. | 32 ₽/сек. | 50 ₽/сек. |
pro | 20 ₽/сек. | 28 ₽/сек. | - | - |
Видео по звуку оплачивается по длине аудио, округлённой вверх до целой секунды: fast - 22 ₽/сек., pro - 28 ₽/сек.
Примеры:
fast, 720p, 6 секунд - 90 ₽; fast, 1080p, 12 секунд - 264 ₽; fast, 2160p, 10 секунд - 500 ₽.pro, 1080p, 8 секунд - 224 ₽.fast - 7 секунд - 154 ₽; аудио 9 секунд в pro - 252 ₽.Полная сумма списывается при создании операции и видна в поле cost. Если операция завершится ошибкой, деньги вернутся на баланс.
Idempotency-Key: повтор одного запроса в течение 24 часов вернёт исходную операцию без повторного списания. Повтор без этого заголовка создаёт новую платную операцию.max_price в теле запроса, чтобы сервер отклонил запуск дороже согласованной суммы до списания.queued, результат забирайте через GET /api/v1/operations/{id}.http/https URL. Адреса localhost и внутренних сетей не принимаются. Картинки - jpg, jpeg, png, webp; аудио - mp3, wav, m4a, aac, flac, ogg, opus.fast, в 720p или 1080p и при 24 или 25 FPS.pro нет разрешений 1440p и 2160p и частоты 48 FPS: такие значения API отклонит с 400 validation_error.pro - длиннее 10 секунд, API отклонит с 400 validation_error ещё до списания.prompt_audio или картинка первого кадра (use_audio_image: true и audio_image_url). С картинкой задание можно не передавать.