API для редактирования нескольких изображений важен, когда одно изображение не является реальной единицей работы. Обновление продукта, кампания или раскадровка обычно начинаются со связанного набора файлов. Полезный результат — это пакет, который можно проверить, с записью о выбранной модели, общей инструкции, идентификаторе запроса и возвращённых результатах.
OdiRouter документирует один API-ключ для мультимодальных возможностей и протокол асинхронной очереди для мультимодальных задач. Этот шаблон можно использовать, чтобы построить контролируемый рабочий процесс вокруг конечной точки для изображений, вместо того чтобы рассматривать каждый результат как изолированный эксперимент.
Сначала определите пакет
Прежде чем отправлять запрос, решите, что следует объединить. Ведите манифест входных данных с исходными файлами, требуемым изменением, размерами выходных данных и критериями приёмки. Это упрощает сравнение повторных запусков при изменении промпта или выбора модели.
{
"batch_name": "spring-product-refresh",
"goal": "Apply one approved visual direction to related product images",
"review_checks": [
"required subject remains recognizable",
"required product details remain visible",
"output matches the approved visual direction"
]
}Проверки должны описывать то, что может проверить рецензент. Они не должны обещать, что каждая модель внесёт одинаковое изменение или сохранит каждую деталь на каждом изображении.
Выберите конечную точку образа OdiRouter
Откройте каталог изображений моделей OdiRoutercategory=Image) и выберите конечную точку, которая соответствует необходимым входным и выходным данным. Записывайте имя конечной точки вместе с пакетом. Это полезнее, чем примечание вроде «использовалась модель для изображений», поскольку позднее рецензенты смогут воспроизвести структуру запроса.
В документе OdiRouter quick-start guide объясняется, как создать и управлять ключом API. Храните ключ в переменной окружения и вызывайте API из серверного компонента. Не следует размещать активный ключ в коде браузера, репозитории исходного кода или в общем журнале запросов.
Отправьте асинхронную задачу
OdiRouter документирует мультимодальную работу через https://api.odirouter.ai/model и путь очереди /v1/queue/{endpoint}. Конечная точка и тело запроса зависят от выбранной модели. Эта форма оболочки является универсальной. Заполните её на основе актуальной документации для выбранной вами модели.
export BASE_URL="https://api.odirouter.ai/model"
export ENDPOINT="your-image-model-endpoint"
curl -sS -X POST "${BASE_URL}/v1/queue/${ENDPOINT}" \
-H "Authorization: Bearer ${ODIROUTER_API_KEY}" \
-H "Content-Type: application/json" \
-d '{"prompt":"Describe the approved change for this batch."}'Сохраните возвращённый request_id вместе с входным манифестом. Документированный поток ответов OdiRouter предоставляет URL статуса и URL ответа для отправленной задачи. Эти значения разделяют этапы отправки, обработки и проверки.
Опрашивайте статус и получайте результат
В документации по быстрому старту описаны промежуточные состояния очереди, такие как IN_QUEUE и IN_PROGRESS, за которыми следует состояние completed. Опрашивайте URL статуса с ограниченным интервалом. Когда задача достигнет состояния COMPLETED, прочитайте URL ответа и сохраните ссылки на результаты рядом с исходной записью пакета.
Не отмечайте пакет как готовый только потому, что запрос был принят. Идентификатор запроса указывает на то, что задача была создана. Это не указывает на то, что полученные данные пригодны для использования в каталоге, рекламной кампании или в качестве производственной функции.
Проанализируйте соответствующие результаты совместно.
Просматривайте связанные результаты рядом друг с другом. Задайте следующие вопросы:
Имеет ли каждое необходимое изображение выходную ссылку?
Содержит ли каждый результат по-прежнему требуемый объект или деталь продукта?
Соответствует ли оформление утвержденным инструкциям?
Соответствуют ли размеры и типы файлов целевому назначению?
Зафиксировал ли проверяющий какой-либо результат, для которого требуется новый запрос?
Этот шаг отделяет успешный ответ API от одобренного творческого результата. Он также делает последующий повторный запуск понятным. Обновите манифест, отправьте новый запрос и сравните новый набор результатов с предыдущей проверкой.
Сделайте рабочий процесс воспроизводимым
Когда процесс проверки стабилизируется, храните вместе конечную точку модели, структуру полезной нагрузки запроса, входной манифест, идентификатор запроса, запись статуса и ссылки на результаты. Эта история помогает инженерным и творческим командам понять пакет без необходимости восстанавливать детали из сообщений чата или по памяти.
Начните с OdiRouter quick-start guide, просмотрите каталог моделей изображений и проверьте pricing перед использованием в продакшене.