Рабочий процесс API Video-to-Video Multi начинается с исходного видео и может использовать другие медиафайлы или инструкции для создания нового результата. Входные данные и поведение вывода зависят от модели. OdiRouter располагает каталогом моделей и документированным процессом мультимодальных задач, поэтому перед тем как считать модель или параметр доступными, проверьте актуальный каталог.
Практическая последовательность проста: подтвердите сведения о модели, подготовьте ресурсы, которые вам разрешено использовать, отправьте задачу, сохраните её идентификатор запроса, опрашивайте статус и получите результат либо сообщение об ошибке. Разрешение, задержка, цена и ограничения на входные данные зависят от конкретной модели, поэтому это руководство не даёт обещаний относительно них.
Сначала проверьте актуальный каталог OdiRouter
Откройте OdiRouter model catalog перед созданием запроса. Убедитесь, что модель указана в каталоге, затем ознакомьтесь с её актуальной страницей и документацией. Проверьте принимаемые типы медиафайлов, обязательные поля, необязательные настройки, тип выходных данных, сведения о ценах и применимые примечания по политике.
Страница модели является источником истины для структуры её запроса. Общее руководство может объяснить схему интеграции, но не может заменить схему, специфичную для конкретной модели. Если модели нет в каталоге, не отправляйте запрос, предполагая, что она есть в наличии.
Подготавливайте видео- и аудиоматериалы ответственно.
Рабочие процессы с видео могут затрагивать людей, голоса и записи, защищённые авторским правом. Храните исходные файлы в контролируемом месте, фиксируйте происхождение каждого ресурса и убедитесь, что у вас есть права и согласие, необходимые для каждого человека и каждой записи в выходном материале.
Перед отправкой задания проверьте каждый файл на соответствие требованиям выбранной модели. Сохраните ссылку на ресурс, тип файла и параметры, специфичные для модели, в своей записи задания. Если запрос завершится ошибкой, эти сведения покажут вашей команде, что именно было отправлено.
Настройте мультимодальный клиент
OdiRouter multimodal setup documentation содержит сведения о базовом URL, конечной точке и заголовках аутентификации для мультимодальных вызовов. Храните учетные данные в хранилище секретов развертывания, а не в клиентском приложении или имени медиафайла.
Храните данные приложения отдельно от учетных данных API. Формируйте запрос из утвержденных ссылок на ресурсы и полей, специфичных для модели, при этом служба, отправляющая запрос, должна считывать данные аутентификации из конфигурации среды выполнения.
Отправьте задачу и сохраните идентификатор запроса
task-submission documentation описывает создание мультимодальной задачи и сохранение ее идентификатора запроса и URL для последующих операций. Сохраните этот идентификатор вместе с записью о задании, как только API примет задачу.
Запишите выбранную модель, время отправки, идентификатор запроса, ссылки на ресурсы, предоставленные вашим приложением, и текущее состояние задания. Принятая отправка не означает, что видео готово. Задача может по-прежнему ожидать выполнения, быть завершенной или находиться в состоянии ошибки.
Проводите опрос целенаправленно и обрабатывайте конечные состояния.
Используйте status-polling documentation для отслеживания задачи. Ваш обработчик должен различать задачу, ожидающую выполнения, и задачу, которая завершилась или вернула ошибку. Используйте ограниченную политику опроса, чтобы у приложения был четкий путь обработки тайм-аута и оно не выполняло лишних запросов.
Если API сообщит об ошибке, сохраните ответ, указав идентификатор запроса и время его получения. Перед тем как принимать решение о целесообразности внесения исправлений, ознакомьтесь с текущей документацией выбранной модели и входными данными. Повторная отправка неизмененных медиафайлов без понимания причины сбоя может скрыть реальную проблему.
Получите и проверьте результат.
result documentation объясняет, как получать мультимодальные результаты или сведения об ошибках. В рабочем процессе обработки видео убедитесь, что возвращенный результат соответствует записи о задании, прежде чем нижестоящая система начнет его использовать.
Предусмотрите короткий этап проверки качества результата и контента, чувствительного с точки зрения прав. Убедитесь, что результат относится к предназначенному запросу, что приложение сохранило правильную ссылку на результат и что использование остается в пределах разрешений, зафиксированных для исходного материала.
Обеспечьте возможность проверки рабочего процесса
Интеграцию проще эксплуатировать, когда проверка каталога, запись об отправке, история статусов, ссылка на результат и сведения об ошибках хранятся вместе. Эта запись дает вашей команде конкретный материал для проверки при изменении модели или сбое задания.
Чтобы ознакомиться с актуальными вариантами и сведениями о запросах, начните с OdiRouter model catalog и перейдите по ссылке multimodal API documentation. Каталог и документация по модели, а не это руководство, определяют, что вы можете отправить сегодня.