Начинайте интеграцию Vidu API преобразования текста в видео на актуальной странице модели OdiRouter, а не со скопированного тела запроса. Допустимые поля и доступность моделей могут изменяться. Используйте OdiRouter model catalog для выбора маршрута, а затем откройте страницу этого маршрута перед разработкой интеграции.
Проверьте актуальный маршрут модели OdiRouter
Карта сайта моделей OdiRouter содержит маршруты преобразования текста в видео Vidu, включая страницу модели преобразования текста в видео Vidu Q3 Pro. Прежде чем писать код для продакшена, проверьте на этой странице поддерживаемые параметры API, сведения о модели и песочницу.
Считайте страницу модели спецификацией запроса, который вы собираетесь отправить. Подтвердите там идентификатор модели, поля запроса, требования к входным данным, поведение выходных данных и требования к учётной записи. Если на странице не описано поле, не предполагайте, что маршрут его принимает.
Составьте промпт, который ваша команда сможет протестировать
Полезный промпт описывает сцену, а не просто нагромождает визуальные прилагательные. Расположите описание объекта, обстановки, действия, замысла работы камеры, освещения и темпа в порядке их важности для кадра. Включайте детали, которые можно проверить в результате.
Для небольшого эксперимента опишите керамический чайник на деревянной столешнице, свет из окна в послеобеденное время, пар из носика и медленное нажатие на чайник. Это пример планирования, а не утверждение о настройке модели или спецификации выходных данных.
Сохраняйте каждый тестовый промпт вместе с записью о его запуске. Так будет проще сравнивать правки и понимать, вызвано ли изменение промптом, выбранным маршрутом модели или рабочим процессом вашего приложения.
Создайте и защитите API-ключ OdiRouter
В документации OdiRouter описана аутентификация с помощью API-ключа. Создайте ключ с помощью процесса работы с аккаунтом OdiRouter, затем храните его в серверном хранилище секретов или переменной окружения. Не размещайте это в клиентском коде, общем блокноте, заявке в службу поддержки или репозитории исходного кода.
В документации используется заголовок авторизации Bearer. Храните этот заголовок и выбранный маршрут модели вне кода формирования промптов, чтобы ротация ключа или смена модели не требовала правок по всему приложению.
curl --location "<current-model-endpoint-from-odirouter>" \
--header "Authorization: Bearer $ODIROUTER_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "Describe the shot you want to test"
}'Используйте только параметры и форматы ввода, указанные на актуальной странице модели. В примере не указаны значения, специфичные для модели, поскольку их источником истины служит страница модели.
Сохраняйте идентификаторы запросов
Генерация видео может выполняться асинхронно. В документации OdiRouter описаны ответы очереди с request_id, response_url, status_url и cancel_url. Сохраняйте значения, возвращаемые вашим запросом, вместе с записью о задаче в приложении.
Храните выбранный маршрут модели, версию промпта, время отправки и собственный идентификатор корреляции вместе с этими полями. Тогда оператор сможет расследовать сбой задачи, не пытаясь угадать, какой запрос её создал.
Успешная отправка не означает, что видео уже готово. Следуйте актуальной документации для возвращённого статуса или URL ответа, дождитесь окончательного результата и обрабатывайте ответ с ошибкой в той же части приложения, которая обрабатывает завершённый результат.
Сделайте опрос удобным в эксплуатации
Выполняйте опрос с ограниченным интервалом и прекращайте его после достижения окончательного состояния. В журнал регистрируются поля безопасной работы, такие как идентификатор корреляции, OdiRouter request_id, маршрут, временные метки и конечный статус. Не записывайте в журналы API-ключи или полные конфиденциальные данные промптов.
Установите тайм-аут, соответствующий возможностям вашего продукта. Если к этому моменту задача не достигла окончательного состояния, покажите, что она ожидает выполнения, и позвольте серверному воркеру продолжать проверку задокументированного URL статуса. Используйте URL-адрес для отмены только в соответствии с указаниями текущей документации.
Проверьте первую интеграцию, прежде чем расширять её
Запустите небольшой набор подсказок с различными темами, действиями и ракурсами камеры. Проверьте, что приложение записывает правильные маршрут и идентификаторы задач, обрабатывает ответ без окончательного статуса и отображает результат только после завершения задокументированного процесса.
Это также подходящий момент, чтобы проверить доступность в каталоге OdiRouter. Страница модели содержит актуальную схему и сведения о модели, а OdiRouter documentation объясняет более общую настройку API и концепции ответов.
Выберите актуальную модель и протестируйте один запрос
Откройте Vidu Q3 Pro text-to-video page on OdiRouter, ознакомьтесь с актуальной схемой запроса и используйте доступную песочницу или рекомендации по API, чтобы протестировать небольшой промпт. После того как жизненный цикл запроса заработает от начала до конца, добавьте собственные механизмы валидации, мониторинга и обработки статусов для пользователей.