Vidu text-to-video API на OdiRouter использует очередь. Отправьте промпт и настройки запроса, сохраните идентификатор задачи, затем проверяйте статус запроса перед получением результата. Это разумный подход для генерации видео, которая не возвращает готовый материал немедленно.
В текущем справочнике OdiRouter для функции «Текст в видео» Vidu Q2 указан эндпоинт viduq2-text2video. Перед развертыванием проверьте актуальный Vidu Q2 text-to-video API reference. Это источник достоверной информации о текущих полях запроса и поведении системы.
Отправить запрос из очереди
Документированный базовый URL — https://api.odirouter.ai/model. Создайте задачу с помощью POST /v1/queue/viduq2-text2video, Authorization: Bearer YOUR_API_KEY и тела запроса JSON. Пример из справочника включает промпт, duration, resolution, seed, aspect_ratio и movement_amplitude.
{
"prompt": "A clean studio shot of a red apple on a white table, soft natural light.",
"duration": 5,
"resolution": "720p",
"seed": 0,
"aspect_ratio": "16:9",
"movement_amplitude": "auto"
}Используйте этот пример как образец запроса, а не как гарантию получения всех возможных результатов. Полезный промпт сообщает модели, что находится в сцене, что меняется и какое впечатление должен создавать кадр. Не указывайте детали, которые не влияют на кадр.
Отслеживайте одну задачу от создания до получения результата
Ответ на создание включает request_id, а также URL-адреса статуса, ответа и отмены. Сохраните этот идентификатор вместе с записью задания вашего приложения. OdiRouter документирует следующие маршруты для того же эндпоинта:
GET /v1/queue/viduq2-text2video/requests/{request_id}/statusGET /v1/queue/viduq2-text2video/requests/{request_id}/responsePUT /v1/queue/viduq2-text2video/requests/{request_id}/cancel
Опрашивайте маршрут состояния по ограниченному расписанию. Когда задача будет готова, вызовите маршрут ответа. Если пользователь прекращает работу, воспользуйтесь описанным в документации способом отмены. Связывайте повторные попытки с собственной записью о задаче, чтобы тайм-аут сети не создал второй запрос.
Упростите сравнение итераций промптов
Описывайте сцену в едином порядке:
Назовите объект и окружение.
Опишите действие или изменение с течением времени.
Добавляйте кадрирование, освещение или стиль, только если это меняет задуманный кадр.
Сохраняйте выбранные поля запроса вместе с
request_id.
Это даст вашей команде запись о том, что изменилось между попытками. Фиксированный seed может быть полезен, когда рабочему процессу требуется снова использовать те же входные данные. Выберите настройки движения и соотношения сторон для размещения видео, затем перед добавлением элементов управления в рабочий код проверьте в актуальном справочнике допустимые значения.
Просмотрите текущие параметры моделей
Используйте справочник API для получения сведений об эндпоинте и полях запроса. Используйте страницу видеомоделей OdiRouter, чтобы ознакомиться с текущими вариантами видеомоделей. Вместе эти страницы позволяют разработчику перейти от поиска модели к документированному пути реализации, не полагаясь на более ранние объявления.
Следующий шаг
Создайте аккаунт OdiRouter, ознакомьтесь с Vidu Q2 text-to-video API reference и протестируйте небольшую отслеживаемую задачу в очереди. Чтобы сравнить варианты, просмотрите текущий каталог видеомоделей OdiRouter.