Документированный жизненный цикл задачи упрощает интеграцию API преобразования текста в изображение FLUX.2 по сравнению с одним непрозрачным запросом. В текущем каталоге OdiRouter указаны flux-2-pro и flux-2-max. Это руководство следует документированному процессу очереди flux-2-pro: отправьте промпт, проверьте задачу и получите результат. Оно не создает конечную точку и не опирается на список моделей, который не был опубликован в OdiRouter.
Начните с документированного маршрута
В справочной документации flux-2-pro используется базовый URL API модели OdiRouter — https://api.odirouter.ai/model. В ней описан эндпоинт создания задачи по адресу /v1/queue/flux-2-pro, а затем эндпоинты статуса, ответа и отмены, использующие возвращаемый идентификатор запроса.
Этот шаблон даёт вашему приложению чёткую запись о созданной им задаче. Сохраните идентификатор запроса вместе с собственным рабочим элементом, выполняйте опрос только с необходимой приложению частотой и получайте результат по документированному URL ответа, когда задача будет готова.
Перед построением маршрута на основе модели проверьте текущую справочную информацию по API FLUX.2 [pro]. Доступность моделей и параметры могут меняться, поэтому справочная документация остаётся источником истины.
Отправьте минимальную задачу генерации изображения
В документированном запросе используются промпт и авторизация Bearer. Также в нём описаны seed, ширина, высота, уровень допустимости безопасности и формат вывода. Этот пример остаётся небольшим. Замените промпт и размер значениями, подходящими для вашего продукта, и храните ключ API вне системы контроля версий.
curl --location "https://api.odirouter.ai/model/v1/queue/flux-2-pro" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "A clear product photo of a red apple on a white table, soft studio lighting.",
"seed": 42,
"width": 1024,
"height": 768,
"safety_tolerance": 2,
"output_format": "jpeg"
}'Согласно документации, для этого маршрута ширина и высота должны быть кратны 32, при этом минимальное значение должно быть 64. В списке вариантов выходного формата указаны jpeg, png и webp. Также в нём описаны необязательные входные изображения для рабочих процессов, которым нужны референсные изображения. Сохраняйте эти технические значения в документированном виде, не пытаясь угадать альтернативные имена полей.
Используйте идентификатор запроса между этапами
Ответ на создание включает request_id, а также URL статуса, ответа и отмены. Жизненный цикл прост:
Отправьте запрос на создание и сохраните идентификатор запроса.
Проверьте документированный эндпоинт статуса для этого идентификатора.
Получите результат из документированного эндпоинта ответа после завершения задачи.
Используйте эндпоинт отмены только тогда, когда вашему приложению задача больше не нужна.
Такое разделение позволяет пользовательскому продукту показать, что задача принята, пока бэкенд сохраняет идентификатор запроса и решает, когда запрашивать следующее состояние.
Пишите промпты для тестируемого рабочего процесса
Начните с промпта, в котором указаны объект, окружение и визуальная обработка. Тест промпта для изображения продукта может содержать описание объекта, фона, освещения и ракурса камеры. Изменяйте по одной переменной за раз. Фиксированный seed полезен, когда вы хотите сравнивать изменения промпта с одной и той же исходной точки.
Ваше приложение должно проверять отправляемые данные. Используйте допустимый размер изображения, выберите один из документированных форматов вывода и сделайте настройку безопасности явным выбором продукта. Эти проверки упрощают диагностику сбоев до того, как запрос попадет в очередь.
Выберите маршрут модели из актуальной документации
В документации OdiRouter в настоящее время указаны и FLUX.2 [pro], и FLUX.2 [max]. Не следует предполагать, что название модели из другого сервиса присутствует в каталоге OdiRouter. Ознакомьтесь с актуальной документацией по моделям, затем выберите маршрут, чьи документированные входные данные и рабочий процесс соответствуют создаваемой вами задаче.
Чтобы получить рекомендации по настройке, выходящие за рамки этого запроса, начните с OdiRouter API documentation. Когда вы будете готовы использовать этот рабочий процесс в своем приложении, create an OdiRouter account.