Руководство по GPT Image API: идентификаторы моделей, маршрутизация и миграция

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

Для новых интеграций изображений напрямую через OpenAI текущий идентификатор модели — gpt-image-2. Для новых интеграций HiAPI используйте gpt-image-2/text-to-image, если задача начинается с промпта, или gpt-image-2/image-to-image, если задача начинается с одного или нескольких референсных изображений.

Эти названия легко перепутать, потому что люди используют «GPT-4o image», «ChatGPT image generation», «GPT Image API» и «GPT Image 2» для обозначения связанных, но разных продуктовых интерфейсов. Надёжный подход — сначала подтвердить, какой API вы вызываете, а затем использовать соответствующие этому API идентификатор модели и контракт запроса.

Интерфейс	Текущая модель или селектор	Режим запроса
OpenAI Image API	gpt-image-2	OpenAI /v1/images/generations или /v1/images/edits
OpenAI Responses API	Поддерживаемая основная модель плюс инструмент генерации изображений	Диалоговая или многошаговая работа с изображениями через /v1/responses
HiAPI текст-в-изображение	gpt-image-2/text-to-image	POST https://api.hiapi.ai/v1/tasks
HiAPI изображение-в-изображение	gpt-image-2/image-to-image	POST https://api.hiapi.ai/v1/tasks

HiAPI не проксирует тело запроса OpenAI Image API. Он предоставляет маршруты GPT Image через унифицированный контракт асинхронных задач, поэтому простая смена имени хоста не считается завершённой миграцией.

Что разработчикам нужно знать о линейке GPT Image

Полезная линейка — это практическая карта миграции. Не все перечисленные ниже названия указывают на взаимозаменяемые модели API.

Название, которое вы можете встретить в старом коде или результатах поиска	Текущий статус	Что делать сейчас
«GPT-4o image generation» или «ChatGPT image generation»	Формулировка продуктового интерфейса или UI, а не текущий идентификатор модели изображений, который можно вставить в новый запрос изображения	Сначала выберите интерфейс API, затем используйте его текущую модель и контракт запроса
chatgpt-4o-latest	Устаревший алиас модели ChatGPT; на текущей странице моделей OpenAI указан ввод изображений, а не вывод изображений	Не используйте его как целевой вариант для миграции генерации изображений
gpt-image-1	OpenAI помечает его как предыдущее поколение, устаревшую модель генерации изображений	Переведите новую работу с изображениями на gpt-image-2
gpt-image-1.5	OpenAI помечает его как предыдущее поколение, устаревшую модель генерации изображений	Переведите новую работу с изображениями на gpt-image-2
dall-e-2 или dall-e-3	Устарели и удалены из OpenAI API	OpenAI рекомендует gpt-image-2 для текущей генерации и редактирования
gpt-image-2	Текущий идентификатор модели прямого подключения к изображениям OpenAI	Используйте с OpenAI Image API или сопоставьте задачу с указанными ниже слэш-идентификаторами HiAPI

Текущая документация OpenAI описывает gpt-image-2 как свою самую продвинутую модель генерации изображений и документирует генерацию из текста и редактирование изображений. Руководство OpenAI по генерации изображений также различает одноразовый Image API и диалоговую генерацию изображений через Responses API. Приведённые выше сведения о статусе моделей взяты со следующих официальных страниц: GPT Image 2, GPT Image 1.5, GPT Image 1, DALL-E 2, DALL-E 3 и ChatGPT-4o, проверено 31 августа 2026 года.

Переход от рабочего процесса UI к рабочему процессу API

Сеансы изображений ChatGPT скрывают выбор модели, состояние, повторные попытки и обработку файлов за диалогом. Интеграция с API должна явно принимать эти решения.

Официальное руководство OpenAI рекомендует использовать его Image API для одиночной генерации или редактирования, а Responses API — для диалоговой, многораундовой работы с изображениями. HiAPI использует третий контракт: каждая задача изображения является асинхронной задачей. Ваш бэкенд отправляет задачу, сохраняет возвращённый taskId и получает окончательный результат через колбэк или более поздний запрос деталей задачи.

Творческое задание из сеанса UI по-прежнему остаётся полезным исходным промптом, но его нужно перенести в реальную схему запроса API и протестировать вывод. Не копируйте название продукта UI в поле model и не предполагайте, что это стабильный идентификатор API.

Для HiAPI храните API key на сервере и отправляйте задачу так:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "Чистый рекламный постер с точным заголовком SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

Объект callback должен находиться на верхнем уровне, рядом с model и input. Для локальной отладки или сверки опрашивайте GET https://api.hiapi.ai/v1/tasks/{taskId}. После успешного выполнения задачи скачивайте изображение из data.output[].url, а не используйте временный URL вывода как постоянное хранилище.

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

Миграция старых вызовов изображений OpenAI в HiAPI

Миграция моделей OpenAI и миграция контракта провайдера — это две отдельные задачи. Сначала выберите текущую задачу изображения, затем перепишите запрос для API задач HiAPI.

Старый ввод	Текущая цель прямого подключения OpenAI	Текущая цель HiAPI
Текст-в-изображение с gpt-image-1, gpt-image-1.5 или идентификаторами DALL-E	Генерация gpt-image-2	gpt-image-2/text-to-image
Редактирование изображений с gpt-image-1 или gpt-image-1.5	Редактирование gpt-image-2	gpt-image-2/image-to-image
Рабочий процесс изображений только в ChatGPT или GPT-4o	Выберите OpenAI Image API или Responses API в зависимости от дизайна взаимодействия	Выберите маршрут задачи HiAPI текст-в-изображение или изображение-в-изображение

При миграции в HiAPI замените синхронную или специфичную для OpenAI обработку ответов сохранением taskId, обработкой конечных состояний и скачиванием вывода. Повторно проверьте промпты и вывод; не обещайте пиксельную идентичность результатов между интерфейсами.

Миграция старых имён моделей HiAPI

HiAPI теперь использует специфичные для задач слэш-идентификаторы и селекторы маршрутов верхнего уровня. Новый код должен использовать каноническую форму запроса, показанную ниже.

Старое имя HiAPI	Текущий запрос
gpt-image-2	model: "gpt-image-2/text-to-image"
gpt-image-2-image-to-image	model: "gpt-image-2/image-to-image"
gpt-image-2-beta	model: "gpt-image-2/text-to-image" плюс route: "beta"
gpt-image-2-ext	model: "gpt-image-2/text-to-image" плюс route: "ext"
gpt-image-2-i2i-ext	model: "gpt-image-2/image-to-image" плюс route: "ext"

Публичные данные о ценах могут записывать элементы с маршрутами как gpt-image-2/text-to-image@ext или gpt-image-2/image-to-image@ext. HiAPI также принимает форму с указанием маршрута, но документация модели использует базовый слэш-идентификатор плюс поле route верхнего уровня, поскольку так легче увидеть схему ввода, специфичную для маршрута.

Замена выведенных из эксплуатации идентификаторов HiAPI Pro

HiAPI вывел из эксплуатации два старых идентификатора Pro 2 июля 2026 года. Они больше не появляются в текущих публичных данных о ценах и не должны сохраняться в новых примерах.

Выведенный из эксплуатации ID	Замена
gpt-image-2-pro	gpt-image-2/text-to-image
gpt-image-2-image-to-image-pro	gpt-image-2/image-to-image

Эта миграция модели не гарантирует, что каждый параметр старого Pro даст точно такой же эффект. Ознакомьтесь с текущей схемой маршрута в соответствующей документации модели, затем перед переключением в продакшене запустите тест с репрезентативным промптом и референсными изображениями.

Куда смотреть дальше

Эта страница посвящена названиям, линейке и миграции. Выберите пункт назначения в зависимости от вопроса, на который хотите ответить:

Начало работы и интеграция

• Страница модели GPT Image 2 для текущей модели и Playground.
• Страница модели GPT Image 2 изображение-в-изображение для редактирования по референсным изображениям в Playground.
• Документация GPT Image 2 текст-в-изображение для полей запросов standard, beta и ext.
• Документация GPT Image 2 изображение-в-изображение для полей редактирования standard и ext, включая различия в именовании референсных изображений.
• Цены API GPT Image 2 для текущей таблицы маршрутов, доплат за референсные изображения и расчёта бюджета.
• Актуальные цены HiAPI для полного текущего каталога моделей.

Сценарии использования и подтверждённые результаты

• Шаблоны промптов GPT Image 2 с реальными выводами.
• Стресс-тест рендеринга текста GPT Image 2.
• Рабочий процесс GPT Image 2 для электронной коммерции.
• Руководство по API GPT Image 2 изображение-в-изображение.

Сравнения и выбор

• GPT Image 2 против Nano Banana 2.
• GPT Image 2 против FLUX 1.1 Pro.
• Честный обзор и тестирование GPT Image 2.

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

Каков текущий идентификатор модели GPT Image API?

Для прямого Image API OpenAI это gpt-image-2. Для HiAPI используйте gpt-image-2/text-to-image или gpt-image-2/image-to-image в зависимости от того, начинается ли задача с текста или с референсных изображений.

Можно ли отправлять в HiAPI голое имя модели gpt-image-2?

Не используйте голое имя в новом коде HiAPI. Текущие канонические идентификаторы — это специфичные для задач слэш-имена, показанные выше; они также делают цены, схему и маршрутизацию страниц моделей более явными.

Использует ли HiAPI конечную точку OpenAI /v1/images/generations?

Нет. Модели изображений HiAPI используют POST /v1/tasks, после чего результат получается через финальный колбэк или GET /v1/tasks/{taskId}. Контракты запросов и ответов OpenAI Image API и API задач HiAPI различаются.

Куда следует помещать колбэк?

Поместите callback на верхний уровень тела задачи, рядом с model и input. Используйте callback.when: "final" и обеспечьте идемпотентность принимающего сервиса по taskId, поскольку и успех, и неудача являются конечными результатами.

Что заменяет gpt-image-2-pro?

Используйте gpt-image-2/text-to-image. Для выведенного из эксплуатации идентификатора изображение-в-изображение Pro используйте gpt-image-2/image-to-image. Перед переключением ознакомьтесь с текущей схемой ввода и протестируйте репрезентативные задачи.