Codex пишет, что `gpt-image-2` не существует: статус, Image API, provider и access

Если Codex показывает The model 'gpt-image-2' does not exist, не начинайте с переименования модели. Сначала определите поверхность, где возникла ошибка: OpenAI уже документирует gpt-image-2, но Codex session, прямой Image API, Responses tool, provider route или доступ организации могут ломаться отдельно.

Начните с этой развилки:

Стоп-правило: если сбой был только в Codex во время incident window, проверьте статус и перезапустите сессию до изменения product code.

Короткий ответ

Одна и та же строка ошибки имеет разные владельцы. В Codex это может быть сбой status/session/tool routing. В прямом API это может быть endpoint, project, organization verification или request shape. У provider-а это чаще model mapping, base URL или upstream access. Поэтому хороший фикс начинается не с guesswork, а с маршрутизации ошибки.

На 3 июня 2026 года OpenAI image generation docs перечисляют gpt-image-2. Значит, сама строка "does not exist" не доказывает глобального отсутствия модели. Она доказывает только то, что конкретная поверхность не смогла ее разрешить.

Почему Codex может так сказать

Codex не равен вашему прямому вызову https://api.openai.com/v1/images/generations. У него есть session state, authentication state, tool availability, route selection и service health. Если слой Codex не может добраться до image route, он может показать model-not-found style message, хотя модель документирована для API.

В русскоязычной разработческой среде легко смешать фразы "Codex не генерирует изображения", ChatGPT Images, provider routes и старые статьи про availability. Поэтому локальный материал должен не повторять общий ответ, а объяснить owner chain: Codex surface, OpenAI Image API, Responses, provider, access gate.

Это важно для команды. Если репозиторий не делает Image API call, а ошибка появилась внутри Codex task, изменение application code добавит новую переменную. Если direct OpenAI проходит, а provider падает, provider owns next step. Если direct OpenAI возвращает access error, проблема не в Codex.

Сначала проверьте OpenAI Status и сессию Codex

Для Codex-only failure идите по короткому списку:

1. Откройте OpenAI Status и посмотрите Codex incident в том же временном окне.
2. Повторите тот же Codex task после monitoring или resolved.
3. Создайте новую сессию, обновите auth, проверьте версию CLI или desktop app.
4. Сохраните timestamp, exact error, project, task и наличие image tool call.
5. Переходите к API tests только если ошибка пережила стабильный статус или появилась вне Codex.

Так вы избегаете ложного ремонта. Переименование gpt-image-2 может скрыть service routing issue и позже испортить billing logs, retries и reproducibility.

Проверьте прямой OpenAI Image API

Чтобы доказать, доступен ли gpt-image-2 для вашего API account, используйте официальный base URL, тот же organization и тот же project, который будет в production.

bash
curl https://api.openai.com/v1/images/generations \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A small lighthouse on a cliff, simple test image",
    "size": "1024x1024"
  }'

Для полного контракта Image API смотрите соседний материал: GPT-Image-2 API Guide.

Не смешивайте Image API и Responses

Image API и Responses image tool имеют разную форму запроса. Direct image job использует Image API и model: "gpt-image-2". Assistant workflow обычно использует main model плюс tools: [{ type: "image_generation" }]. Перенос syntax между ними часто создает ошибку, которая внешне похожа на model-not-found, но имеет другого владельца.

js
const response = await client.responses.create({
  model: "gpt-5.5",
  input: "Create a simple test image and explain the composition.",
  tools: [{ type: "image_generation" }]
});

Считайте этот код shape example. Конкретный main model может измениться, но split между direct image endpoint и Responses tool остается главным правилом.

Provider и custom base URL

OpenAI-compatible provider может принимать OpenAI-style names, но иметь свой model map, billing, availability, fallback и upstream account. Если provider возвращает The model 'gpt-image-2' does not exist, это может означать отсутствие mapping, другой alias, region restriction или upstream account без доступа.

Проверьте:

• base URL действительно https://api.openai.com/v1 или provider/proxy URL?
• model list provider-а включает gpt-image-2 exactly?
• нужен ли другой endpoint, route name или image mode?
• не смешан ли provider key с OpenAI docs?
• price, speed, availability, no-refund или quota claims проверены в текущем run?

laozhang.ai можно упоминать только как provider route для API/developer/gateway job. Его price или coverage нельзя писать как official OpenAI pricing.

Access, project и organization gates

Документированная модель не гарантирует доступ для каждого key или project. Image API access может зависеть от organization verification, project scope, region/account state и key permissions. ChatGPT или Codex subscription также не равны Platform API access.

Когда direct OpenAI падает, соберите:

• endpoint и base URL
• model name
• request id или response headers
• organization и project
• verification state
• timestamp with timezone
• region, network path, proxy
• самый короткий reproducible request

С таким пакетом support понимает owner: Codex, OpenAI API, provider, network или access.

После восстановления статуса

Если статус уже resolved, но Codex продолжает падать:

1. Повторите тот же task один раз.
2. Создайте fresh Codex session или обновите authentication.
3. Обновите Codex CLI / app.
4. Запустите direct Image API test из той же сети.
5. Проверьте provider model list и base URL отдельно.
6. Перед ticket сохраните minimal repro и request IDs.

Остановитесь, когда одна поверхность проходит. Direct OpenAI pass + provider fail значит provider owns next check. Fresh Codex pass значит session or route state. Direct OpenAI access error значит org/project issue.

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

gpt-image-2 действительно существует?

Да. OpenAI image generation docs перечисляют gpt-image-2 в этом run. Codex error не доказывает глобальное отсутствие модели.

Нужно ли заменить модель на другую?

Нет, не первым шагом. Меняйте name только если документация вашей фактической route требует другой supported model или alias.

Direct API работает, но Codex все еще падает. Что это значит?

Ваш application API route, вероятно, не первый owner. Обновите Codex session, retry после stable status и сохраните direct API success как evidence.

Provider возвращает HTTP 400 или model_not_found. Что делать?

Проверьте provider model list, base URL, endpoint, billing и upstream access. Если OpenAI direct работает, issue belongs to provider.

План ChatGPT или Codex гарантирует Image API access?

Нет. Product access, Codex tool и Platform API key являются разными поверхностями.

Какие evidence сохранить?

Exact error, route surface, model name, base URL, endpoint, org/project, timestamp, request id, status-page state и minimal reproduction.