API редактирования изображений с ИИ должен быть частью воспроизводимого продуктового процесса, а не разовым полем для промпта. С OdiRouter сначала проверьте актуальный каталог моделей изображений, выберите модель, документированные входные данные которой подходят для задачи, и размещайте интеграцию на сервере. При изменении каталога вы сможете проверить модель и структуру запроса до внесения изменений в код продукта.
Начните с актуального каталога моделей
Запросы на редактирование изображений могут различаться обработкой исходного изображения, настройками промпта, параметрами вывода, модерацией и жизненным циклом задачи. Не стройте решение вокруг устаревшего руководства по интеграции. Откройте каталог моделей изображений OdiRouter, подтвердите, что модель доступна вашей учётной записи, и прочитайте её карточку, прежде чем писать код для продакшена.
В актуальном каталоге gpt-image-2-edit задокументирована как модель редактирования изображений, а также указаны конечная точка отправки и конечные точки статуса и ответа. Это полезный пример рабочего процесса, но это не означает, что каждая модель изображения принимает одни и те же поля или параметры.
Храните ключ API на сервере.
Создайте API-ключ и управляйте им через OdiRouter, затем загружайте его из серверного секрета или переменной окружения. В OdiRouter, принадлежащем getting-started documentation, разработчикам рекомендуется не прописывать API-ключи в коде и не вызывать API напрямую из браузера или мобильного клиента. Ваша серверная часть может проверять ввод пользователя, применять правила авторизации, отправлять задачу и возвращать только ту информацию о результате, которая необходима вашему приложению.
export ODIROUTER_API_KEY="your-server-side-key"Не размещайте настоящий ключ в клиентском JavaScript, публичном репозитории, снимке экрана или отчёте о проблеме. Смените и замените ключ, если подозреваете его раскрытие.
Отправьте задачу редактирования через документированную конечную точку модели
Используйте точную структуру запроса, указанную в текущей документации модели. В примере каталога для gpt-image-2-edit используется приведённая ниже конечная точка задачи OdiRouter. Значение image является примером входных данных. Выберите источник входных данных, на использование которого ваше приложение имеет разрешение, и проверьте его перед отправкой.
curl --location 'https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit' \
--header "Authorization: Bearer $ODIROUTER_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "Describe the permitted edit clearly.",
"image": "https://example.com/your-authorized-source-image.png"
}'Рассматривайте ответ на отправку как состояние задачи, а не как готовый ресурс. Сохраните возвращённый идентификатор запроса вместе с собственной записью о задании. Затем ваш сервис сможет связать действие пользователя с документированными вызовами статуса задачи и ответа задачи.
Проверяйте статус перед использованием результата
Документированный рабочий процесс включает конечную точку статуса и конечную точку ответа в пути задачи модели. Запрашивайте статус с идентификатором запроса, используйте ограниченное число повторных попыток при временных сбоях и получайте ответ только тогда, когда задача готова. Отделяйте логику обработки ответа поставщика от сообщения, показываемого пользователю, чтобы ожидающая задача не отображалась как готовое изображение.
curl --location 'https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit/requests/{request_id}/status' \
--header "Authorization: Bearer $ODIROUTER_API_KEY"
curl --location 'https://api.odirouter.ai/model/v1/queue/gpt-image-2-edit/requests/{request_id}/response' \
--header "Authorization: Bearer $ODIROUTER_API_KEY"Храните только данные, необходимые вашему приложению, и соблюдайте средства контроля доступа и правила хранения, применимые к вашим пользователям и исходным изображениям. Если ваш продукт поддерживает повторные попытки, убедитесь, что задержанный сетевой ответ не может привести к отправке дублирующихся правок.
Используйте небольшой контрольный список для продакшена
Перед выпуском проверьте следующее:
Выбранная модель присутствует в текущем каталоге OdiRouter, и описанные в документации поля запроса соответствуют вашей реализации.
Ваш бэкэнд хранит API-ключ OdiRouter; браузер его никогда не получает.
Ваше приложение проверяет, что каждое исходное изображение разрешено использовать для запрошенной правки.
Обработка запросов, отслеживание статуса и результатов осуществляется с помощью единой, надежной записи.
В вашем продукте предусмотрены явные состояния для тайм-аутов, ошибок поставщика и отмены пользователем.
Ваш интерфейс не обещает параметр модели или характеристику результата, которые не описаны в текущей документации модели.
Проверьте модель, затем создайте минимальный безопасный путь
Начните с тестовой интеграции, которая отправляет одну разрешённую правку, записывает её идентификатор задачи и получает результат через документированные конечные точки. Просматривайте каталог моделей изображений OdiRouter каждый раз, когда добавляете параметр, специфичный для модели. Для настройки учётной записи и общих рекомендаций по API используйте OdiRouter documentation.