API генерации ИИ-видео: text-to-video на TypeScript

API генерации ИИ-видео превращает промпт в видео через асинхронный запуск: запустите Video Generator, проверяйте состояние по полученному идентификатору и после завершения прочитайте URL видео из ресурсов. TypeScript SDK Pipe2 предоставляет эти публичные операции напрямую, поэтому интеграция text-to-video получается компактной.

Запуск text-to-video через TypeScript SDK

Установите @pipe2-ai/sdk, сохраните токен Pipe2 в PIPE2_TOKEN и запустите этот модуль с помощью Node. В примере описано одно наблюдаемое действие и короткая временная последовательность, чтобы генератору было проще создать цельный план.

import { createClient } from '@pipe2-ai/sdk';

const input = {
  prompt: '[0-3s] A paper airplane circles above a classroom. [3-6s] It lands beside a notebook. Gentle room ambience, no music.',
};
const client = createClient(process.env.PIPE2_TOKEN);
const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: 'video-generator',
  input,
});

while (true) {
  const { pipeline_runs_by_pk: run } = await client.GetPipelineRun({
    id: run_pipeline.run_id,
  });
  if (run?.status === 'completed') {
    console.log(run.assets?.[0]?.url);
    break;
  }
  if (run?.status === 'failed') throw new Error(run.error_message ?? 'Video generation failed');
  await new Promise((resolve) => setTimeout(resolve, 3000));
}

Тот же запрос к pipeline без кода авторизации и опроса выглядит так:

{
  "pipeline_slug": "video-generator",
  "input": {
    "prompt": "[0-3s] A paper airplane circles above a classroom. [3-6s] It lands beside a notebook. Gentle room ambience, no music."
  }
}

В документации TypeScript SDK описаны установка, авторизация, запуск pipeline, проверка статуса, подписки, загрузка ресурсов и операции с кредитами.

Как устроены запуск, опрос и получение ресурса

RunPipeline принимает slug pipeline и входной JSON-объект. Операция не держит запрос открытым до конца генерации, а возвращает идентификаторы нового запуска. Сохраните run_pipeline.run_id: именно его использует GetPipelineRun.

Каждый запрос состояния возвращает актуальную запись запуска. Запуск со статусом completed может содержать созданные ресурсы, и пример выводит URL первого из них. При статусе failed доступно сообщение об ошибке, которое нужно показать пользователю или записать в журнал. В рабочем сервисе также задайте общее ограничение времени и считайте отсутствие запуска ошибкой, а не продолжайте опрос бесконечно.

Для небольшого скрипта достаточно проверять статус раз в несколько секунд. Если сервису нужны непрерывные обновления, SDK предлагает WatchPipelineRun — асинхронный итератор того же состояния запуска.

Начните с самого простого корректного ввода

В запросе есть только prompt. Это минимальный полезный ввод для text-to-video; выбор модели остаётся в режиме Auto. Video Generator также поддерживает начальный или конечный кадр и необязательные изображения, видео или аудио в качестве референсов. Допустимые длительность, разрешение, соотношение сторон и количество референсов зависят от совместимого маршрута модели.

Добавляйте настройку только тогда, когда она нужна продукту. Для целевой площадки может потребоваться конкретное соотношение сторон, для сохранения образа — референс, а для более длинного ролика — другой совместимый маршрут. Перед более дорогим или насыщенным медиа запросом вызовите EstimatePipelineCost с теми же pipeline_slug и input.

Составьте промпт для одного генерируемого плана

API не заменяет точное описание кадра. Укажите видимое действие, поведение камеры, окружение, временную последовательность и звук. Действие должно быть физически выполнимым за заданное время.

В примере два временных интервала, но одно непрерывное событие: бумажный самолётик кружит и затем приземляется. Здесь нет смены локации, нескольких персонажей или монтажа. Поэтому проще проверить непрерывность движения, форму объекта, момент приземления и звук.

Для большой работы генерируйте и принимайте каждый план отдельно, а затем собирайте их. В руководстве о том, как создавать видео с ИИ, разобраны планирование, проверка, монтаж, субтитры и финальная обработка после вызова API.

Явно обрабатывайте авторизацию и ошибки

Создавайте клиент с токеном Pipe2 и храните токен на сервере или в защищённой локальной переменной окружения. Не помещайте его в код, доставляемый браузеру, не фиксируйте в репозитории и не добавляйте во входные данные pipeline.

Разделяйте ошибки отправки и сбои уже созданного запуска. Запрос может завершиться до старта, если он не авторизован, некорректен или для него нельзя зарезервировать необходимые кредиты. Успешно созданный запуск позже может получить статус failed; проверьте error_message. Используйте URL ресурсов только после статуса completed.

Если процесс начинается с изображения, загрузите ресурс или укажите его через документированный SDK-процесс и воспользуйтесь практическим руководством по созданию видео из изображения.