API для преобразования изображения в 3D-модель преобразует входное изображение в 3D-результат посредством запроса модели. Для промышленной интеграции необходим воспроизводимый способ выбрать актуальную модель, отправить задачу, отслеживать её выполнение, получить результат и определить, пригоден ли он для использования в приложении.
Документ OdiRouter описывает API моделей для производственных целей, включая LLM-модели, изображения, видео, аудио и 3D-модели. Его model API overview описывает мультимодальную работу как асинхронный поток через очередь. Этот документированный жизненный цикл обеспечивает чёткую структуру для интеграции преобразования изображения в 3D.
Определите результат до выбора входных данных
Зафиксируйте, что требуется следующему этапу продукта от сгенерированного 3D-результата. Предпросмотр продукта, интерактивный просмотрщик, рабочий процесс создания игровых ассетов и внутренняя проверка дизайна могут требовать разных проверок. Определите, относится ли задача к одному объекту, какие визуальные детали важны и как приложение будет проверять возвращённый результат.
Используйте изображение, которое позволит легко идентифицировать основной объект. По возможности удаляйте посторонние объекты. Не полагайтесь на скрытые стороны или мелкие детали, которых нет на изображении. Если результат зависит от нескольких ракурсов, включите это требование в план оценки до сравнения моделей.
Перед развертыванием проверьте текущую модель.
Не следует жестко задавать выбор модели на основе старого объявления или отдельного теста. Откройте OdiRouter model catalog, просмотрите сведения о текущей модели и убедитесь, что выбранная модель подходит для выполнения работы. Доступность, поддерживаемые входные данные, поля ответа и цены должны содержаться в актуальной информации о моделях, а не быть постоянными предположениями в коде приложения.
Отделяйте продуктовое решение от жизненного цикла API. Сохраняйте выбранную конечную точку вместе с каждой задачей. Эта запись упрощает сравнение результатов и последующий пересмотр выбора модели.
Отправка, опрос и получение задачи
OdiRouter документирует мультимодальные запросы через асинхронную очередь. Документированный жизненный цикл использует следующие пути:
Создайте задачу с помощью
POST /model/v1/queue/{endpoint}.Проверяйте ход выполнения с помощью
GET /model/v1/queue/{endpoint}/requests/{request_id}/status.Получите завершённый результат с помощью
GET /model/v1/queue/{endpoint}/requests/{request_id}/response.Отмените задачу, если отмена поддерживается, с помощью
PUT /model/v1/queue/{endpoint}/requests/{request_id}/cancel.
В официальном обзоре endpoint указан как идентификатор модели OdiRouter и объясняется, что тело запроса содержит параметры выбранной модели. Используйте multimodal setup documentation для аутентификации, выбора конечной точки и сведений о запросе для выбранной модели.
Сохраните идентификатор конечной точки и запросите его сразу после создания задачи. Опрашивайте статус из воркера или другого контролируемого фонового процесса, а не удерживайте запрос браузера открытым. После завершения получите ответ и передайте на следующий этап приложения только ожидаемый результат.
Проверьте возвращённый результат
Завершённый запрос запускает контроль качества продукта. Сверьте результат с определёнными ранее требованиями. Проверьте, можно ли распознать объект, сохранились ли важные видимые детали и могут ли полученные данные поступить в программу просмотра или в последующий конвейер обработки без недокументированного преобразования.
Поддерживайте небольшой набор для оценки, похожий на реальные входные данные. Включите ракурсы объекта, фоны и уровни детализации, которые будут отправлять пользователи. Записывайте выбранную конечную точку, результат запроса и причину, по которой вывод прошёл или не прошёл проверку. Это обеспечивает более надёжное сравнение, чем один удачный пример.
Стройте решение на основе документированного поведения
Начните с документированного жизненного цикла очереди и добавьте вокруг него проверки, специфичные для продукта. Не обещайте конкретный формат вывода, качество материалов, топологию, время обработки или цену, пока актуальная документация не подтвердит это для выбранной модели.
Просмотрите OdiRouter's model catalog, прочитайте Model API overview и создайте учётную запись через регистрацию OdiRouter, когда будете готовы протестировать актуальную модель в своём рабочем процессе.