Рабочий процесс редактирования изображений с помощью API ИИ с использованием OdiRouter

Редакция OdiRouter

API для редактирования изображений с использованием ИИ — это больше, чем просто запрос и выходной файл. Для производственной интеграции нужны документированная модель, четкая структура запроса, способ отслеживать асинхронную задачу и этап проверки до того, как результат попадет к пользователям. OdiRouter публикует модели изображений и API-справочники для конкретных моделей, необходимые для этого рабочего процесса.

Начните со справочника модели

Выберите возможность редактирования изображений из каталога моделей изображений OdiRouter, затем перед написанием интеграции ознакомьтесь с актуальным API-справочником. На странице модели вы подтверждаете конечную точку, поля запроса и жизненный цикл, которые должно поддерживать ваше приложение.

Текущий GPT Image 2 Edit API reference описывает поток на основе очереди. В нем перечислены конечные точки для создания запроса, проверки статуса, получения ответа и отмены запроса. У принятого запроса на редактирование изображения результат может быть готов не сразу, поэтому это разделение следует учесть в архитектуре приложения.

Отправьте запрос на редактирование

Для данного API модели документированный базовый URL — https://api.odirouter.ai/model, а запросы используют Authorization: Bearer YOUR_API_KEY. Конечная точка создания — POST /v1/queue/gpt-image-2-edit.

Приведенный ниже пример соответствует опубликованной форме запроса. Замените URL-адрес изображения и подсказку на материалы, которые ваше приложение имеет право обрабатывать.

curl --location "https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "Replace the background with a clean white studio setup while preserving the product details.",
    "images": ["https://example.com/input.png"],
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "background": "auto",
    "output_format": "jpeg",
    "output_compression": 90,
    "moderation": "auto"
  }'

Сохраните URL-адрес изображения, подсказку и выбранные параметры в записи запроса. Эта запись помогает вашей команде связать результат с запрошенным изменением. Эти параметры взяты из справочника этой модели, поэтому при выборе другой модели изображений снова изучите соответствующую документацию.

Отслеживайте очередь

Документированный ответ на создание для gpt-image-2-edit включает идентификатор запроса и URL-адреса для статуса, ответа и отмены. Сохраните идентификатор запроса вместе с задачей приложения. Проверяйте документированный URL-адрес статуса, пока задача ожидает выполнения; когда она будет готова, получите результат по документированному URL-адресу ответа; URL-адрес отмены используйте только в том случае, если вашему продукту необходимо остановить запрос в очереди.

Поток прост:

  1. Проверьте ввод пользователя и создайте запрос на редактирование.

  2. Сохраните идентификатор запроса и URL-адрес статуса вместе с задачей приложения.

  3. Опрашивайте статус, используя ограниченную политику повторных попыток, подходящую для продукта.

  4. Получите ответ после готовности задачи.

  5. Примените правила проверки, относящиеся к этому рабочему процессу.

Не стройте логику приложения на предполагаемом времени завершения. Следуйте жизненному циклу, возвращаемому актуальным справочником модели.

Пишите промпты, которые можно проверить

Промпт для редактирования легче оценить, когда в нем указаны изменение, ограничения и то, что должно остаться неизменным. Например, в запросе для изображения товара можно указать изменение фона при сохранении деталей товара. В рамках фирменного стиля можно указать визуальные ограничения и разместить исходный материал рядом с результатом.

Предоставьте проверяющим конкретное решение, которое им нужно принять. Расплывчатые промпты затрудняют утверждение результатов и диагностику последующих правок. Не допускайте попадания учетных данных и URL-адресов приватных ресурсов в журналы на стороне клиента и обрабатывайте только материалы, на использование которых у вас есть разрешение.

Добавьте проверки вокруг вызова API

API модели обрабатывает запрос. Приложение по-прежнему отвечает за сопутствующую работу.

  • Перед отправкой убедитесь, что исходное изображение разрешено в рамках рабочего процесса.

  • Сохраняйте идентификатор запроса и конечную точку выбранной модели для поддержки и отладки.

  • Ограниченное количество запросов и четкое отображение состояния, если задача не завершается должным образом.

  • Проверьте размеры вывода, формат и видимое содержимое на соответствие запрошенному редактированию.

  • Предусмотрите возможность утверждения человеком, если изображение будет опубликовано или использовано в чувствительном процессе.

Эти проверки упрощают эксплуатацию интеграции, не обещая определенного визуального результата.

Что делать дальше

Используйте каталог моделей изображений OdiRouter, чтобы увидеть доступные в настоящее время варианты для изображений. Чтобы ознакомиться с конечными точками очереди и полями запроса из этого руководства, откройте GPT Image 2 Edit API reference. Если вы настраиваете учетную запись и первый запрос, продолжите с OdiRouter getting started guide.

Источники

#API для генерации изображений#API для редактирования изображений с ИИ#OdiRouter#редактирование изображений