GPT Image 2 API с единой ценой за изображение

1. Создайте ключ

   Зарегистрируйтесь, пополните баланс от $5 и создайте ключ на странице API-ключи. Модели изображений обслуживаются в группе каналов gpt-value, поэтому используйте ключ в режиме Auto или привязанный к этой группе.

2. Направьте OpenAI SDK на Lovely Router

   Укажите базовый URL https://lovelyrouter.com/v1. Запросы проходят в том виде, в каком их определяет OpenAI, поэтому официальные SDK работают без изменений.

3. Создайте изображение

   POST /v1/images/generations держит соединение, пока изображение не будет готово, и возвращает его в base64 в поле b64_json.

   cURLPythonNode.js

   Shell

   curl https://lovelyrouter.com/v1/images/generations \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "model": "gpt-image-2",
       "prompt": "A watercolor painting of a red fox in a snowy birch forest at dawn",
       "size": "1024x1024",
       "quality": "medium"
     }' | jq -r '.data[0].b64_json' | base64 --decode > fox.png

Обычно изображение создаётся от 40 секунд до 2 минут, плюс время ожидания в очереди. Шлюз отвечает в пределах девяти минут, поэтому задайте HTTP-клиенту тайм-аут не меньше десяти. response_format: "url" игнорируется: изображения всегда возвращаются в base64.

Чтобы отредактировать изображение или дать модели референсы (товар, логотип, человека, стиль), отправьте до 16 изображений и, при желании, mask в POST /v1/images/edits с любой из моделей: файлами multipart/form-data или ссылками в JSON. Редактирование стоит столько же, сколько генерация.

curl https://lovelyrouter.com/v1/images/edits \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F model=gpt-image-2 \
  -F image=@fox.png \
  -F prompt="Make it night with a full moon" | jq -r '.data[0].b64_json' | base64 --decode > fox-night.png

Каждый запрос изображения встаёт в очередь и начинается, как только освобождаются мощности, поэтому всплеск запросов ждёт своей очереди, а не завершается ошибкой. У каждого аккаунта может быть до 20 изображений в очереди или в генерации одновременно. Если не хотите держать соединение открытым минутами, используйте задачи изображений:

# Submit: returns 202 with the job id and its queue_position
curl https://lovelyrouter.com/v1/images/jobs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "gpt-image-2", "prompt": "A red fox in a snowy birch forest", "size": "1536x1024"}'

# Wait up to 60 seconds for it, then download the file
curl "https://lovelyrouter.com/v1/images/jobs/img_8c1f0e2a9b7d4f3e6a5c2b1d?wait=60" \
  -H "Authorization: Bearer $LOVELY_API_KEY"
curl -o fox.png https://lovelyrouter.com/v1/images/jobs/img_8c1f0e2a9b7d4f3e6a5c2b1d/content \
  -H "Authorization: Bearer $LOVELY_API_KEY"

Задача принимает те же поля, что и генерация; входные изображения превращают её в редактирование. Изображение завершённой задачи доступно 7 дней. Можно получить список недавних задач и отменить задачу, которая ещё в очереди. Если синхронный запрос не завершился за девять минут, он отвечает 504 с id задачи в заголовке x-lovely-image-job, а изображение продолжает генерироваться, и его можно забрать как задачу.

Чтобы попробовать промпты и редактирование без кода, переключите песочницу в режим Изображения. Она работает на задачах изображений.

Агенты тоже умеют создавать изображения. У MCP-сервера есть инструмент generate_image, который использует GPT Image 2.5, а если 2.5 недоступна — GPT Image 2, по той же цене за изображение, и принимает референсы по URL. Он отвечает ссылкой для скачивания, которая 24 часа работает без ключа, и командой curl, сохраняющей файл; get_image ждёт изображение, которое ещё не готово. Добавьте сервер в Claude Code:

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

Затем попросите: «Сгенерируй главное изображение 1536x1024 с маяком в сумерках в стиле плоской иллюстрации и сохрани его в public/hero.png».

Единая цена $0.04 за изображение — для генерации и редактирования, при любом размере и качестве. Объект usage в ответе носит справочный характер и на цену не влияет.

При отправке изображения его цена резервируется на балансе и списывается, когда изображение готово. Плата не взимается, если запрос отклонён, задача отменена или изображение не получилось. Сгенерированное изображение оплачивается, даже если ваш клиент отключился до его получения. Подписки нет; другие продукты на том же балансе смотрите на странице цен.