API для дорисовки изображений с ИИ редактирует выбранную часть существующего изображения, сохраняя остальную сцену без изменений. Основные входные данные — исходное изображение, маска, обозначающая редактируемую область, и промпт, описывающий требуемое изменение. OdiRouter документирует маршрут Midjourney Inpaint для этого типа дополнительного редактирования изображений, включая создание запроса, проверку статуса, получение результата и отмену.
Используйте текущую версию OdiRouter Midjourney Inpaint API reference в качестве источника достоверной информации об актуальной схеме запроса.
Определите изменение перед отправкой запроса
Дорисовка имеет больше ограничений, чем создание нового изображения. Опишите изменение внутри отмеченной области, а не повторяйте все детали сцены. «Удалите этикетку и сохраните бутылку, освещение и фон» даёт проверяющему гораздо более ясную цель, чем запрос на переработку всего изображения.
Зафиксируйте исходное изображение и ожидаемый результат перед отправкой запроса на редактирование. В задаче по очистке изображения товара это может означать удаление отражения или небольшого дефекта. В задаче по восстановлению сцены это может означать правдоподобное расширение фона. Эта запись помогает проверяющим отличить успешное локальное изменение от нежелательного изменения за пределами маски.
Рассматривайте маску как границу редактирования.
Маска указывает модели, где она может вносить изменения. Располагайте её близко к области, которую нужно изменить, и по возможности оставляйте незатронутые области за её пределами. Большая маска предоставляет модели ненужные варианты выбора и затрудняет проверку результата.
Документированный запрос OdiRouter Midjourney Inpaint принимает объект mask, содержащий либо URL, либо определённые области. Для области в справочной документации указаны width, height и полигон points. Задокументированный диапазон ширины и высоты составляет от 500 до 4096 пикселей, и для построения многоугольника требуется не менее шести значений координат. Проверяйте эти значения перед постановкой запроса в очередь, чтобы ошибка ввода не превратилась в сбой производственной задачи.
Используйте одну цель редактирования для каждой маски, если вам нужен предсказуемый результат проверки. Если восстановление фона и замена объекта требуют разной визуальной обработки, отправляйте отдельные запросы или сначала убедитесь, что документация модели поддерживает запрос с несколькими областями для этой задачи.
Следуйте жизненному циклу запроса OdiRouter
Midjourney Inpaint model page и справочник API описывают асинхронный рабочий процесс с очередью. Документированная конечная точка создания — POST /v1/queue/midjourney-inpaint в разделе https://api.odirouter.ai/model. Для каждого запроса требуется заголовок Authorization: Bearer YOUR_API_KEY.
Для повторного редактирования документированный запрос включает предыдущий jobId и значение imageNo. В справочнике перечислены значения imageNo от 0 до 3. Также в нём документирован remixPrompt с диапазоном длины от 1 до 8192 символов. Ответ на создание предоставляет URL-адреса, специфичные для запроса, для проверки статуса, получения ответа и отмены. Сохраняйте эти URL-адреса вместе с записью о задаче, а не предполагаете путь к результату.
Документированный жизненный цикл:
Создайте запрос на редактирование с исходной задачей, выбором изображения, маской и
remixPrompt.Проверяйте URL-адрес статуса, используя ограниченное число повторных попыток.
Получите данные по URL-адресу ответа после того, как запрос достигнет конечного состояния.
Используйте документированный URL-адрес отмены только в том случае, если задачу следует остановить.
Это позволяет приложению сообщать о ходе выполнения, не рассматривая редактирование изображения, поставленное в очередь, как немедленный ответ.
Проверяйте входные данные и результаты в вашем приложении.
Перед вызовом создания проверьте URL-адреса изображений, размеры, координаты многоугольника, длину промпта и авторизацию. Регистрируйте идентификатор запроса и возвращённые URL-адреса, но никогда не помещайте ключ API в журналы приложения. Установите политику ограниченного опроса и явно обрабатывайте состояния сбоя на конечном этапе.
Когда ответ успешно получен, сравните результат с исходным изображением и маской. Начните с границы маски, затем проверьте освещение, текстуру и края вокруг измененной области. Храните исходный ресурс, маску, промпт и запись об ответе вместе, чтобы у следующей редакции был необходимый контекст.
Выберите документированный маршрут для задачи
В текущем OdiRouter model catalog перечислено несколько маршрутов для генерации и редактирования изображений. Маршрут, описанный как инпейтинг, не является автоматически заменой для любой задачи редактирования. Поля ввода, правила для исходного изображения, асинхронное поведение и элементы управления редактированием зависят от конкретной модели. Перед тем как жёстко закодировать тело запроса, ознакомьтесь с актуальной документацией для выбранного маршрута.
Для производственного процесса определите маршрут в каталоге, прочитайте его справочник API модели и протестируйте небольшой набор редактирований с масками, похожих на ваши реальные изображения. Изучите текущие OdiRouter pricing, прежде чем оценивать производственный бюджет.
Создавайте правки, удобные для проверки
Редактированием изображений проще управлять, когда у каждого запроса есть известный исходный ресурс, небольшая область редактирования, сфокусированный промпт и зафиксированный результат. Начните с документированного OdiRouter Midjourney Inpaint API, явно определите жизненный цикл запроса и перед развёртыванием проверьте ограничения, специфичные для модели.