API-ключ GPT Image 2: как получить доступ и отправить первый запрос

Да, у GPT Image 2 есть API, и в SeedRouter доступ к нему даёт один API-ключ. Войдите в аккаунт, создайте ключ на странице API-ключей, пополните кредиты на странице оплаты и передавайте ключ в заголовке Authorization: Bearer на https://api.seedrouter.ai/v1/images/generations. Полностью ключ показывается только один раз, при создании, поэтому сразу скопируйте его в переменные окружения своего сервера.

Шаги ниже проведут вас от отсутствия аккаунта до готового изображения и разберут четыре ошибки, на которых спотыкается большинство первых запросов.

Как получить API-ключ GPT Image 2?

1. Войдите в SeedRouter через аккаунт Google.
2. Откройте API-ключи и создайте ключ. Дайте ему имя, из которого понятно, где он будет работать, например production-server.
3. Сразу скопируйте ключ. После этого экрана вы увидите только замаскированную версию, а потерянный ключ восстановить нельзя. Вместо этого отзовите его и создайте новый.
4. Пополните кредиты на странице оплаты. Ключ работает сразу после создания, но для выполнения запроса нужны кредиты.

Один ключ открывает доступ ко всем моделям SeedRouter, поэтому отдельный ключ для GPT Image 2 и GPT Image 2.5 не нужен. Лучше создайте отдельные ключи для каждого окружения. Тогда отзыв ключа staging не сломает production.

Где хранить API-ключ?

На своём сервере, в переменной окружения, и больше нигде:

export SEEDROUTER_API_KEY="your-key"

Никогда не размещайте ключ в браузерном JavaScript, в сборке мобильного приложения или в публичном репозитории. Любой, кто его прочитает, сможет тратить ваши кредиты. Если у вашего продукта есть фронтенд, пусть он обращается к вашему бэкенду, а бэкенд вызывает API с ключом.

Если ключ всё же утёк, сразу отзовите его на странице API-ключей. Отозванный ключ перестаёт работать, и запросы с ним отклоняются.

Как отправить первый запрос с ключом?

Передайте ключ как bearer-токен. В ответ приходит ссылка на задачу, а не изображение:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Сохраните id из ответа и опрашивайте GET https://api.seedrouter.ai/v1/tasks/{id} с тем же заголовком, пока status не станет completed. Завершённая задача содержит URL изображений. Полный цикл в коде показан в статье GPT Image 2 API на Python.

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

С какими ошибками обычно сталкивается новый API-ключ?

Большинство неудач первого запроса вызывают две оплошности. Первая — ключ вставлен без одного символа или с лишним пробелом, что возвращает 10001. Вторая — имя модели скопировано из заголовка, например gpt-image-2.0 или GPT Image 2, вместо ID модели, что возвращает 20002. Оба запроса отклоняются до начала работы, поэтому ничего не списывается.

Есть ли бесплатный API-ключ GPT Image 2?

Нет. Создать ключ можно бесплатно, но запросы оплачиваются из предоплаченных кредитов. Не оплачиваются только неудачи: задача, которая завершилась со статусом failed или не вернула изображение, ничего не стоит. Кредиты покупаются разовыми пополнениями, не сгорают и не требуют подписки, поэтому небольшого первого пополнения хватит, чтобы как следует протестировать интеграцию.

Можно ли использовать один ключ из Python и JavaScript?

Да. Ключ — это строка в HTTP-заголовке, поэтому его может использовать любой язык, умеющий отправлять HTTP-запросы. В каждой среде читайте его из окружения: os.environ["SEEDROUTER_API_KEY"] в Python и process.env.SEEDROUTER_API_KEY в Node.js. Держите JavaScript на стороне сервера: тот же ключ в браузерном коде виден каждому посетителю.

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

Нужен ли API-ключ OpenAI, чтобы использовать здесь GPT Image 2?

Нет. Ваш ключ SeedRouter — единственные учётные данные, которые вы отправляете. Чтобы вызывать GPT Image 2 через этот API, не нужно создавать отдельный аккаунт где-то ещё и управлять им.

Сколько API-ключей можно создать?

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

Где посмотреть, сколько потратил ключ?

В истории расходов. Для каждого запроса указаны модель и списание, поэтому новую интеграцию легко сверить со своей оценкой.

Держите ключ на сервере и запускайте

Создайте ключ для каждого окружения, храните его в переменной окружения и передавайте как bearer-токен только со своего бэкенда. Когда первый запрос вернёт id задачи, с доступом покончено; всё остальное описано в справочнике GPT Image 2 API.