API Flux Kontext Max принимает текстовую инструкцию и, при необходимости, визуальные референсы для рабочего процесса обработки изображений. В текущей справке API FLUX.1 Kontext [max] сервиса OdiRouter указана модель для генерации и редактирования изображений. Его конечная точка очереди — https://api.odirouter.ai/model/v1/queue/flux-kontext-max; требуется prompt, а в справке перечислены необязательные входные изображения.
Полезная последовательность проста: тщательно выберите исходные изображения, отправьте документированный запрос и используйте возвращённые URL-адреса задач. Принятый запрос — это не то же самое, что готовое изображение.
Начните с брифа на редактирование и набора референсов
Прежде чем писать промпт, определите, что должно остаться неизменным. Это может быть форма продукта, поза человека, угол съёмки или компоновка. Затем укажите элементы, которые могут измениться, например фон, освещение, одежду, оформление текста или один объект.
Документированные параметры включают input_image, input_image_2 и input_image_3. Каждый из них принимает данные изображения в формате Base64 или URL-адрес изображения. Используйте референсы, добавляющие чёткое ограничение. Если одно изображение задает композицию, а другое предоставляет подробную информацию о продукте, укажите это в задании. Добавление нескольких референсов без ясной цели делает последующую проверку неоднозначной.
Опишите визуальные изменения, желаемое соотношение сторон и формат вывода. Связывайте подсказку с тем, что может показать изображение. Оно не должно содержать утверждений о реальном продукте, человеке или событии, которые изображение не может подтвердить.
Отправьте запрос через OdiRouter
Документ OdiRouter описывает асинхронный запрос в очередь для этого маршрута. В примере конечная точка и распространённые параметры остаются на виду. Добавьте input_image, когда для задачи требуется исходное изображение или референс.
curl --location "https://api.odirouter.ai/model/v1/queue/flux-kontext-max" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "Replace the background with a clean studio setting while keeping the product centered.",
"input_image": "https://example.com/reference.png",
"seed": 42,
"aspect_ratio": "1:1",
"output_format": "png",
"prompt_upsampling": false,
"safety_tolerance": 2
}'В справочных материалах также перечислены seed, aspect_ratio, output_format, prompt_upsampling и safety_tolerance. Задавайте их осознанно. Фиксированный seed может помочь при сравнении изменений в промпте. Выберите соотношение сторон и формат вывода для места, где будет отображаться изображение. Настройте параметр безопасности в соответствии с политикой проверки вашего приложения.
Рассматривайте ответ как жизненный цикл задачи
Первый ответ включает request_id, а также URL-адреса результата, статуса и отмены. Сохраняйте возвращённые значения вместе с записью о задаче. Запрашивайте status_url для отслеживания прогресса и response_url для получения завершённого результата. Если задача в очереди больше не нужна, используйте возвращённый cancel_url, а не формируйте его по памяти.
Это предоставляет фоновому обработчику или интерфейсу стабильный идентификатор задачи. Это также обеспечивает привязку опроса к запросу, создавшему задачу. Храните вместе исходный промпт, выбранные референсы, значения параметров и идентификатор задачи. Затем рецензент может увидеть, каким образом был запрошен результат.
Проверяйте результаты до того, как их увидят пользователи
Добавьте этап проверки изображений после генерации. Сравнивайте результат с ограничениями, заданными до отправки. Проверьте тему, необходимые визуальные детали, текст внутри изображения и желаемое соотношение сторон. Если результат не соответствует какому-либо требованию, по возможности корректируйте по одному ограничению за раз. Тогда следующий результат будет проще оценить.
При работе с несколькими референсами используйте небольшой набор для оценки, а не судите о рабочем процессе по одному результату. Проводите контролируемые тесты промптов на одних и тех же исходных изображениях, затем отмечайте, какая инструкция была изменена. Это не подтверждает универсальное качество. Это даёт команде воспроизводимый способ оценивать изменение промпта или параметра применительно к собственному сценарию использования.
Проверяйте актуальную документацию перед запуском
Доступность моделей, поддерживаемые параметры и цены могут меняться. Прежде чем прототип станет производственным рабочим процессом, ознакомьтесь с актуальным OdiRouter model catalog и справочником API FLUX.1 Kontext [max]. Используйте каталог для сравнения актуальных вариантов. Используйте справочник API для получения сведений о структуре запроса и жизненном цикле задачи.
Создайте ключ API OdiRouter, выберите документированный маршрут модели, отправьте точный промпт с необходимыми референсами, сохраните возвращённые URL-адреса задачи и проверьте результат, прежде чем ваше приложение начнёт его использовать.