Как пользоваться API LTX 2.5 Fast для генерации видео из текста? Первое видео за 5 минут

TL;DR

• LTX 2.5 Fast Text to Video (ltx-2.5-fast/text-to-video) превращает текст в видео длиной 2–20 секунд: 720p / 1080p, горизонтальная и вертикальная ориентация, оригинальная аудиодорожка — всё вместе. Откройте страницу модели, чтобы попробовать; новым пользователям при регистрации дарим 200 кредитов.
• Цена считается посекундно: 720p — $0.043 за секунду ($0.258 за 6 секунд), 1080p — $0.086 за секунду; переключатель generate_audio не влияет на цену.
• Вызов идёт через интерфейс HiAPI /v1/tasks: отправьте задачу и получите taskId, затем запросите результат; после успеха возьмите адрес видео из output (временный адрес, сохраняйте вовремя).

Что он умеет

• Озвученный кадр одной фразой: сцена, движение, камера и звук пишутся в одном промпте, аудио генерируется вместе с изображением.
• 2–20 секунд, 12 вариантов длительности: duration принимает 2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 18, 20, по умолчанию 6 секунд.
• Горизонтальная и вертикальная ориентация и два разрешения: 16:9 / 9:16, 720p / 1080p; частота кадров фиксированная — 25fps MP4.
• В этой же серии есть генерация видео из изображения: ltx-2.5-fast/image-to-video загружает первый кадр (можно добавить последний), чтобы оживить статичное изображение; правила цены те же, см. страницу модели генерации видео из изображения.

Как выбрать между двумя интерфейсами:

	ltx-2.5-fast/text-to-video (эта страница)	ltx-2.5-fast/image-to-video
Вход	Текст	1–2 изображения + описание движения
Подходит для	Поиск кадра с нуля, рекламные идеи, раскадровки	Есть фото продукта/снимок, нужно его оживить
Точки контроля	Промпт, разрешение, длительность, формат кадра	Первый кадр (+последний), промпт, разрешение, длительность

Коротко: если содержимое кадра ещё не определено — используйте генерацию из текста, если кадр уже есть — из изображения; интерфейсы можно объединить: сгенерировать из текста финальный первый кадр, а затем передать его в генерацию из изображения, чтобы добавить движение камеры.

Ниже реальный готовый ролик (720p · 6 секунд, с оригинальной аудиодорожкой):

A barista pours steamed milk into a latte, creating a leaf pattern, close-up, soft morning light through a café window, gentle clinking cups and café ambience

(По-китайски: бариста наливает взбитое молоко в латте, создавая узор в виде листа, крупный план, мягкий утренний свет через окно кафе, тихий звон чашек и атмосфера кафе. Параметры по умолчанию: 720p, 6 секунд, 16:9, звук включён.)

ltx-2.5-fast/text-to-video, 720p, 6 секунд, 16:9, 1280×720, со звуком, $0.258.Смотреть полный ролик →

Сгенерировать с этим промптом →

Два пути к началу работы

3 шага в браузере: откройте страницу модели → вставьте промпт, выберите длительность и разрешение → нажмите «Сгенерировать»; 720p 6 секунд — $0.258 за ролик, после генерации можно сразу посмотреть онлайн.

3 шага через API: POST /v1/tasks отправить → получить taskId → GET /v1/tasks/<taskId> дождаться success и скачать.

curl: первый ролик

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: your-unique-key-001" \
  -d '{
  "model": "ltx-2.5-fast/text-to-video",
  "input": {
    "prompt": "A barista pours steamed milk into a latte, creating a leaf pattern, close-up, soft morning light through a café window, gentle clinking cups and café ambience",
    "resolution": "720p",
    "duration": 6,
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Этот ролик 720p × 6 секунд стоит $0.258.

Python: отправка, опрос, скачивание

import time, uuid, requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

payload = {
    "model": "ltx-2.5-fast/text-to-video",
    "input": {
        "prompt": "A barista pours steamed milk into a latte, creating a leaf pattern, close-up, soft morning light through a café window, gentle clinking cups and café ambience",
        "resolution": "720p",
        "duration": 6,
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
}

resp = requests.post(
    BASE,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json=payload,
    timeout=30,
)
resp.raise_for_status()
task_id = resp.json()["taskId"]

while True:
    task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()
    print(task["status"])
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    video = next(o for o in task["output"] if o.get("type") == "video")
    video_url = video["url"]   # 临时地址，尽快下载保存
    mp4 = requests.get(video_url, timeout=120)
    with open("output.mp4", "wb") as f:
        f.write(mp4.content)
    print("saved output.mp4")

Таблица параметров

Поле	Обязательно	Значения	Описание
prompt	Да	1–5000 символов	Опишите всё одной фразой: сцену, движение, камеру, звук
resolution	Нет	720p / 1080p, по умолчанию 720p	Цена 1080p за секунду примерно в 2 раза выше, чем 720p
duration	Нет	2/3/4/5/6/8/10/12/14/16/18/20, по умолчанию 6	Допустимы только эти значения перечисления (нет 7, 9)
aspect_ratio	Нет	16:9 / 9:16, по умолчанию 16:9	Для вертикальных коротких видео выбирайте 9:16
generate_audio	Нет	По умолчанию true	Оригинальная аудиодорожка; отключение не снижает цену

Если в теле запроса есть поля вне таблицы, вернётся 400.

Ошибки, с которыми вы столкнётесь

Код состояния	Значение	Что делать
400 INVALID_REQUEST	Некорректное тело запроса (отсутствует prompt, в duration передано 7 или другое недопустимое значение, переданы поля вне таблицы)	Исправьте тело запроса по таблице параметров
402 INSUFFICIENT_QUOTA	Недостаточно средств (списание не происходит)	Пополните баланс и повторите
429 RATE_LIMITED	Превышен лимит запросов	Снизьте частоту отправки
409 / 422 IDEMPOTENCY_KEY_*	Повторная отправка с тем же ключом идемпотентности	Укажите новый Idempotency-Key

При неудачном завершении задачи также возможны CONTENT_POLICY_VIOLATION, TASK_FAILED, TASK_TIMEOUT и др.; за неудачу плата не списывается.

Перед запуском в продакшен

• Callback: передайте на верхнем уровне тела запроса "callback": {"url": "https://..."} — уведомление о завершении придёт автоматически; видеозадачи выполняются долго, поэтому рекомендуется использовать.
• Своевременно сохраняйте: адрес видео в output временный, скачивайте сразу после получения.
• Явно указывайте duration и resolution: эти два поля определяют счёт, не полагайтесь на значения по умолчанию; перед запуском логируйте эти два значения, чтобы при сверке всё было ясно.
• Ритм пакетной обработки: от отправки до готовности 6-секундного видео проходит некоторое время; для пакетных задач рекомендуется очередь отправки + получение результатов через callback, не ждите синхронно.
• Нужно оживить статичное изображение: используйте страницу модели генерации видео из изображения из этой же серии, загрузка первого кадра даёт больше контроля.

Частые вопросы

• Да, аудио генерируется вместе с видео: generate_audio по умолчанию включён; если описать звук в промпте (шум ветра, тихий звон чашек), аудио будет точнее соответствовать изображению.
• Да, длительность имеет только 12 вариантов: значения перечисления от 2 до 20 секунд; 7 секунд, 9 секунд и подобные вызовут 400.
• Да, цена = цена за секунду × количество секунд: 720p 6 секунд — $0.258, 1080p 6 секунд — $0.516; отключение аудио не делает дешевле.
• Да, на $10 можно сделать около 38 роликов: считая по 720p 6 секунд за ролик.
• Да, для вертикального формата выбирайте 9:16: на выходе 720×1280 (720p) или 1080×1920 (1080p), для публикации на платформах коротких видео обрезать не нужно.
• Да, разрешение рекомендуется сначала низкое, потом высокое: для настройки промпта и композиции используйте 720p, а когда определились, повысьте до 1080p и перезапустите с тем же промптом; цена за секунду вдвое выше, но готовый ролик будет только один.
• Да, отключение аудио не экономит: если нужна пост-озвучка и музыка, передайте generate_audio: false, чтобы получить чистое изображение.

Следующий шаг: возьмите промпт с латте-артом и сгенерируйте первый ролик на странице модели; четыре шаблона сцен смотрите в сборнике промптов для генерации видео из текста.