GPT Image 2 в Codex, Claude Code и других ИИ-агентах для программирования

ИИ-агент для программирования, например Codex или Claude Code, может генерировать изображения GPT Image 2, напрямую вызывая API. Поместите API-ключ в переменную окружения, дайте агенту промпт ниже, и он соберёт запрос, покажет его вам, отправит после вашего одобрения, опросит задачу и сохранит изображения в ваш проект. Плагин не нужен: API может вызвать любой агент, который умеет выполнить команду в оболочке или короткий скрипт.

SeedRouter не предлагает MCP-сервер или готовый skill. Промпт из этого руководства — это вся интеграция. Его можно сохранить как многоразовую инструкцию в любом агенте, которым вы пользуетесь.

Что нужно агенту перед началом работы?

Три вещи:

1. API-ключ в окружении. Создайте его на странице API-ключей и экспортируйте в оболочке, где работает агент. Агент читает его оттуда; он никогда не должен просить вас вставить ключ.
2. Доступ к сети. Агент обращается к https://api.seedrouter.ai, поэтому его песочница должна разрешать исходящие запросы для этой задачи.
3. Кредиты. Запросы оплачиваются с вашего баланса, поэтому пополните его перед первым запуском.

export SEEDROUTER_API_KEY="your-key"

Какой промпт дать агенту?

Вставьте его в начале задачи, затем заполните цель в квадратных скобках. В нём перечислены именно те поля, которые принимает API, поэтому агент не выдумывает параметры, и он заставляет агента остановиться и дождаться вашего одобрения, прежде чем что-либо будет списано:

Use the SeedRouter API to generate a gpt-image-2 image for me.

Security: read SEEDROUTER_API_KEY from my local environment. Never ask me to paste it and never expose it in code, prompts, logs, or output.

Goal:
- Use case: [product / social / concept art / UI mockup]
- Subject and style: [subject, composition, lighting, style]
- Size: [auto | 1024x1024 | 1536x1024 | 1024x1536 | WIDTHxHEIGHT]
- Quality: [auto | low | medium | high]
- Number of images: [1-10]
- Acceptance criteria: [e.g. no text in the image, consistent product, clean background]

Request fields this endpoint accepts, and nothing else:
  model (required, "gpt-image-2"), prompt (required, up to 32000 chars),
  n (1-10, default 1), size (default auto; a custom WIDTHxHEIGHT must have
  both sides divisible by 16, neither edge over 3840, total pixels between
  655360 and 8294400, and keep a ratio between
  1:3 and 3:1), quality (auto|low|medium|high, default auto),
  background (auto|opaque|transparent, default auto; transparent requires
  output_format png), output_format (png|jpeg, default png),
  output_compression (0-100, default 100, jpeg only),
  moderation (auto|low, default auto), user (your own identifier).
For editing use /v1/images/generations with images: [{image_url: "https://..."}]
(up to 16) and optional mask: {image_url: "https://..."}. Mask requires images.
Inputs must be URLs, not base64 or multipart files. stream and partial_images
are not supported because delivery is asynchronous.

Before any paid request, show me the model id, the exact request body and the
estimated cost, then wait for my explicit approval.

After approval:
1. POST https://api.seedrouter.ai/v1/images/generations with the body above and
   an Authorization: Bearer $SEEDROUTER_API_KEY header.
2. Save the task id from the response "id" field. The response is
   {"id": "...", "status": "processing"} — the image is not in it.
3. Poll https://api.seedrouter.ai/v1/tasks/{task_id} with the same header every
   5-10 seconds until status is "completed" or "failed". Do not retry forever;
   if you stop waiting, preserve the task id and report that it is still pending.
   A polling timeout is not a failed task. Never submit a duplicate just to check status.
4. On success, download every URL in output.data[].url, return the local paths,
   the task id, and the parameters used. The response carries no cost field.
5. On failure, keep the task id, explain the reason and what to change, and do
   not retry without my approval. A task that ends failed is not charged.

Важнее всего шаг одобрения. Агент, который повторяет запросы сам, может отправить один и тот же платный запрос несколько раз. Оставьте эту инструкцию на месте, даже когда начнёте доверять настройке.

Как использовать его в Codex?

Откройте Codex в своём проекте и вставьте промпт с заполненной целью. Чтобы использовать его повторно, добавьте промпт в файл проекта AGENTS.md — файл инструкций, который Codex читает для репозитория, — под заголовком вроде «Генерация изображений». После этого достаточно запроса вроде «сделай hero-изображение для страницы цен»; Codex выполнит сохранённые шаги.

Если Codex работает в песочнице без доступа к сети, он не сможет достучаться до API. Разрешите доступ к сети для этой сессии, прежде чем просить его сгенерировать изображение.

Как использовать его в Claude Code?

Тот же промпт работает в Claude Code. Для повторного использования сохраните его в файле проекта CLAUDE.md или как skill: папку с файлом SKILL.md, инструкции в котором содержат промпт. Тогда Claude Code подгружает его, когда вы просите изображение. Убедитесь, что SEEDROUTER_API_KEY экспортирован в терминале, из которого вы запускаете Claude Code.

Как выглядит хороший запуск агента?

1. Вы описываете изображение и где оно должно появиться.
2. Агент показывает ID модели, точное тело запроса и оценку стоимости — и ждёт.
3. Вы одобряете. Агент отправляет запрос один раз и сообщает ID задачи.
4. Он опрашивает задачу до завершения, скачивает изображения в проект и сообщает пути к файлам.

Если запуск остановился на полпути, ID задачи остаётся действительным. Попросите агента возобновить опрос этого ID, а не генерировать заново: вторая отправка — это второе списание. Задача, которая завершилась со статусом failed, не оплачивается.

Часто задаваемые вопросы

Есть ли у SeedRouter MCP-сервер или skill для GPT Image 2?

Нет. Интеграция — это сам API, а промпт выше даёт агенту всё, что нужно для его вызова. Если хотите использовать промпт повторно, сохраните его как skill или файл инструкций в своём агенте.

Может ли агент редактировать существующие изображения в моём проекте?

Да, если изображения доступны по публичным HTTPS-URL. API принимает референсные изображения и маски как URL, а не как локальные файлы, поэтому сначала загрузите их или скажите агенту, где они размещены.

Какую модель должен использовать агент?

gpt-image-2 — если нужна одна фиксированная цена за каждое доставленное изображение, или gpt-image-2-official — чтобы платить за токены, о которых сообщает каждый рендер. Чтобы переключиться, замените модель в промпте. Текущие цены — на странице модели.

Оставьте последнее слово за человеком

Дайте агенту ключ через окружение, поля — через промпт, а последнее слово оставьте за собой через шаг одобрения. Такое сочетание позволяет Codex или Claude Code создавать изображения прямо в вашем проекте без неожиданных списаний. В справочнике GPT Image 2 API описано каждое поле, если захотите расширить промпт.