GPT Image 2 — полное руководство
По состоянию на 2026-10-20 GPT Image 2 (gpt-image-2) — выпущенная 21 апреля 2026 года модель генерации и редактирования изображений OpenAI с гибкими размерами и высокоточной обработкой входных изображений. Официальная оплата — за токены изображения: $8 за ввод, $2 за кэшированный ввод и $30 за вывод за 1M токенов; в Batch — $4 / $1 / $15. В QCode оплата идёт за число выходных изображений: $0.30 за изображение, одинаково для generations и edits; это отдельная схема, не совпадающая с официальной оплатой за токены изображения.
Что такое GPT Image 2
GPT Image 2 — модель генерации и редактирования изображений, выпущенная OpenAI 21 апреля 2026 года; ID модели gpt-image-2, снимок по умолчанию gpt-image-2-2026-04-21. По словам OpenAI, она поддерживает гибкие размеры и высокоточную обработку входных изображений и вызывается через эндпоинты generations и edits Images API. DALL·E 2 и DALL·E 3 удалены из API 12 мая 2026 года; OpenAI рекомендует использовать gpt-image-2 и другие актуальные модели. По состоянию на 2026-10-20 вышли также GPT Image 2.5 Sunburst и Flare (8 сентября 2026 года), и официальное руководство советует новые интеграции строить на серии 2.5.
Ключевые возможности
Генерация по тексту, генерация по изображению, локальная перерисовка, текст внутри изображения, разные разрешения (1024x1024 / 1024x1536 / 1536x1024, до 4K в официальном API) и уровни качества (low / medium / high / auto). OpenAI тарифицирует по токенам изображения: размер, качество и число входных изображений меняют число токенов, а значит и итоговую стоимость.
Тарификация: $0.30 за изображение
GPT Image 2 тарифицируется за каждое выходное изображение, одинаково для generations и edits: $0.30 за изображение, значит n изображений = n × $0.30. size, quality, число входных изображений, mask и длина prompt на цену не влияют. Неудачные запросы (4xx, включая отказы модерации, 5xx, таймауты, обрыв соединения клиентом) не тарифицируются. С 2026-10-06 тарификация изменена с потокенной на $0.30 за изображение.
- За каждое выходное изображение — $0.30
- size / quality / число входных изображений / mask / длина prompt на цену не влияют
- Неудачные запросы (4xx / 5xx / таймауты / обрыв соединения) не тарифицируются
Цена не зависит от size / quality и от числа входных изображений — считается только по числу выходных изображений.
Доступ через QCode
GPT Image 2 есть в каталоге /models; актуальную доступность проверяйте по каталогу /models и странице статуса, а не по тексту статичной страницы. Оплата — за каждое выходное изображение по $0.30, одинаково для generations и edits. Та же квота тарифа QCode работает в нескольких CLI-инструментах, например Claude Code и OpenAI Codex.
generations и edits стоят одинаково; n изображений = n × $0.30.
4xx (включая отказы модерации) / 5xx / таймауты / обрыв соединения клиентом — ничего не списывается.
Пример настройки API
Используйте OpenAI-совместимый API. Просто укажите BASE_URL на QCode endpoint, используйте QCode Key как API Key — всё остальное идентично официальному SDK.
from openai import OpenAI
import base64
# Внимание: генерация изображений идёт через отдельный эндпоинт /qcode-img/v1 (а не через текстовый /openai/v1)
client = OpenAI(
api_key="$QCODE_KEY",
base_url="https://api.qcode.cc/qcode-img/v1",
timeout=180.0, # OpenAI SDK default is short, recommend 180s
)
response = client.images.generate(
model="gpt-image-2",
prompt="A serene Japanese garden with a koi pond",
size="1024x1024",
quality="medium",
)
img = base64.b64decode(response.data[0].b64_json) # Возвращается только b64_json; response_format=url отклоняется с 400
open("out.png", "wb").write(img)
# Полный путь эндпоинта: POST https://api.qcode.cc/qcode-img/v1/images/generationsСценарии использования
Маркетинговые материалы, постеры для соцсетей, изображения товаров e-commerce, иллюстрации книг, концептуальные эскизы, графика для презентаций, UI-мокапы, прототипы дизайна. Для локальных правок используйте эндпоинт edits с маской или объединяйте несколько референсных изображений в новое.
Переход с DALL·E 3 и сравнение с Midjourney / Stable Diffusion
DALL·E 3: по официальному changelog OpenAI, dall-e-2 и dall-e-3 были удалены из API 12 мая 2026 года, а в качестве замены рекомендовались модели вроде gpt-image-2, поэтому интеграции, которые всё ещё вызывают DALL·E 3, нужно перевести. vs Midjourney: API-first дизайн подходит для программной интеграции; Midjourney ориентирован на Discord-творцов. vs Stable Diffusion: закрытый источник, но более стабильное качество и управляемость, без необходимости GPU. По состоянию на 2026-10-15 официальное руководство OpenAI рекомендует для новых интеграций модели GPT Image 2.5; выбирайте между gpt-image-2 и моделями 2.5 по качеству, размеру и задачам редактирования.
QCode также поддерживает OpenAI Codex / GPT-5.6
Баланс плана QCode единый для Claude Code и OpenAI Codex CLI — без двойной оплаты.
Частые вопросы
Можно ли ещё пользоваться DALL·E 3 или стоит перейти на GPT Image 2?
В API OpenAI — уже нет: по официальному changelog dall-e-2 и dall-e-3 удалены из API 12 мая 2026 года, а OpenAI рекомендовала вместо них gpt-image-2, gpt-image-1 или gpt-image-1-mini. gpt-image-2 поддерживает гибкие размеры и входные изображения с высокой точностью и умеет делать локальные правки через эндпоинт edits; по странице устаревших моделей OpenAI, gpt-image-1 планируется отключить 23 октября 2026 года, замена — модели GPT Image 2.5 (по состоянию на 2026-10-15).
Как тарифицируется GPT Image 2?
По числу выходных изображений: $0.30 за каждое. Для generations и edits цена одинаковая, n изображений = n × $0.30. size, quality, число входных изображений, mask и длина prompt на цену не влияют, неудачные запросы не тарифицируются. Официальная цена OpenAI — отдельная схема: за токены изображения, $8 за ввод, $2 за кэшированный ввод и $30 за вывод за 1M токенов; в Batch — $4 / $1 / $15 (официальный прайс, 2026-10-20).
Как подключиться к GPT Image 2 из материкового Китая?
В документации QCode для материкового Китая по умолчанию указан https://api.qcode.cc/qcode-img/v1, для Гонконга и Юго-Восточной Азии — https://asia.qcode.cc/qcode-img/v1, для Северной Америки и Европы — https://us.qcode.cc/qcode-img/v1 (Лос-Анджелес). gpt-image-2 присутствует в каталоге /models; фактическая доступность определяется каталогом /models и страницей статуса — эта страница ничего не обещает в реальном времени.
Можно ли использовать квоту тарифа QCode для GPT Image 2?
Квота тарифа QCode работает в нескольких CLI-инструментах (Claude Code, OpenAI Codex и т.д.) с одним API Key. gpt-image-2 есть в каталоге /models — доступность сверяйте по /models и странице статуса; запросы на изображения учитываются в dailyCostLimit из расчёта $0.30 за изображение.
gpt-image-2 на практике: параметры, подключение, редактирование и ошибки
Официальные параметры gpt-image-2 вкратце
По состоянию на 2026-10-15 официальный changelog OpenAI указывает, что GPT Image 2 вышла 21 апреля 2026 года; ID модели — gpt-image-2, снапшот по умолчанию — gpt-image-2-2026-04-21. В таблице эндпоинтов на официальной странице модели генерация изображений (v1/images/generations), редактирование (v1/images/edits) и Batch (v1/batch) отмечены как поддерживаемые; на вход подаются текст и изображения, на выходе получается изображение.
Среди популярных размеров OpenAI называет 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 и значение по умолчанию auto. Произвольный размер должен одновременно соответствовать условиям: длинная сторона не больше 3840px, обе стороны кратны 16px, соотношение длинной и короткой сторон не больше 3:1, общее число пикселей от 655 360 до 8 294 400. Параметр quality принимает low, medium, high или auto по умолчанию.
- Формат вывода: Image API возвращает изображение в кодировке base64, по умолчанию png, по запросу jpeg или webp; для jpeg и webp степень сжатия задаёт output_compression (0–100).
- Точность обработки входных изображений: по словам OpenAI, gpt-image-2 автоматически обрабатывает каждое входное изображение с высокой точностью и не позволяет менять input_fidelity, поэтому этот параметр просто не передают.
- Прозрачный фон: согласно официальному changelog, с 20 августа 2026 года gpt-image-2 в режиме предварительной версии поддерживает background=transparent при выводе в png или webp; jpeg прозрачность не поддерживает.
- Время генерации: в разделе об ограничениях OpenAI пишет, что сложные промпты могут обрабатываться до 2 минут.
- Модерация: все промпты и результаты фильтруются по контентной политике OpenAI, параметр moderation принимает auto (по умолчанию) или low.
Вызов gpt-image-2 через QCode за три шага
В документации QCode описан отдельный путь для изображений, совместимый с форматом запросов и ответов OpenAI Images API: оставьте официальный SDK OpenAI, укажите base_url https://api.qcode.cc/qcode-img/v1, в api_key — ключ QCode, в качестве модели — gpt-image-2, остальной код менять не нужно. Можно ли вызвать модель прямо сейчас, смотрите в каталоге /models и на странице статуса.
Если хотите попробовать до написания кода, в документации QCode указан онлайн-Playground по адресу https://api.qcode.cc/qcode-img/: введите ключ API и промпт и проверьте генерацию и редактирование прямо в браузере.
- Шаг 1: зарегистрируйтесь в QCode и создайте в панели управления ключ API (начинается с cr_); тот же ключ подходит для Claude Code, Codex и других инструментов.
- Шаг 2: запрос пишется так же, как для OpenAI. В model укажите gpt-image-2; n — от 1 до 4 изображений за вызов, при значении больше 4 вернётся ошибка 400, без молчаливого урезания; если не передать size и quality, эндпоинт генерации по умолчанию использует 1024x1024 и medium. Фактический размер полученного изображения иногда отличается от запрошенного size — ориентируйтесь на само изображение.
- Шаг 3: явно задайте тайм-аут клиента не меньше 180 секунд. Документация QCode предупреждает, что тайм-аут SDK OpenAI по умолчанию слишком короткий; если между вами стоит собственный обратный прокси или шлюз, его тайм-аут чтения тоже должен быть не меньше 180 секунд.
- Получение результата: data[0].b64_json в ответе — это изображение в base64, его нужно декодировать и записать в файл; revised_prompt — промпт, переписанный моделью, его можно показать пользователю.
- Лимиты по умолчанию: по документации QCode на один ключ API приходится 100 изображений в сутки и не больше 2 одновременных запросов, общие для generations и edits; для увеличения обратитесь в поддержку.
Редактирование через edits: перерисовка области и объединение изображений
Запрос на редактирование отправляется на POST /qcode-img/v1/images/edits, файлы загружаются как multipart/form-data, а не JSON. По документации QCode за один запрос можно передать от 1 до 8 исходных изображений (PNG, JPEG или WebP), повторяя поле image для каждого; mask необязателен — это PNG с альфа-каналом, прозрачная часть которого и будет перерисована.
Официальное руководство OpenAI требует, чтобы изображение и mask были одного формата и размера, меньше 50MB, а mask содержал альфа-канал. Там же поясняется, что редактирование по маске в GPT Image полностью опирается на промпт: модель использует маску как ориентир и может не повторять её форму точно; если входных изображений несколько, маска применяется к первому.
- Маска показывает, где менять, а промпт — на что менять. Без маски по промпту может быть перерисована любая часть изображения.
- При объединении нескольких изображений опишите в промпте роль каждого, например: первое — сцена, второе — товар, который нужно в неё поместить.
- Размер загрузки: по документации QCode один файл — до 25 MB, все файлы вместе — до 50 MB; при превышении возвращается 413 image_too_large.
- input_fidelity передавать не нужно: gpt-image-2 всегда обрабатывает входные изображения с высокой точностью, QCode игнорирует low и high, а на другие значения отвечает 400.
Частые ошибки и что с ними делать
Ошибки графических эндпоинтов QCode следуют стандартной схеме OpenAI (error.type, error.code, error.message), поэтому ориентируйтесь на HTTP-статус и code.
- 400 unsupported_response_format: передан response_format=url. Этот эндпоинт возвращает только b64_json.
- 400 unsupported_background: передан background=transparent. Официальный API OpenAI поддерживает прозрачный фон в предварительном режиме, но, по документации QCode на 2026-10-15, /qcode-img/v1 принимает только auto и opaque.
- 400 stream_not_supported: передан stream=true или partial_images; потоковая выдача пока не поддерживается.
- 422 unsupported_size: size не входит в список auto, 1024x1024, 1024x1536, 1536x1024, 2048x2048; произвольные размеры вроде 4K, которые принимает официальный API, на этом эндпоинте не поддерживаются.
- 429 image_daily_limit или concurrency_exhausted: достигнут суточный лимит изображений или лимит одновременных запросов на ключ; подождите время из заголовка Retry-After и повторите.
- 503 image_provider_unavailable, 504 или тайм-аут клиента: повторяйте с экспоненциальной задержкой по Retry-After (документация советует начинать с 30 секунд, не более 3 попыток); если тайм-ауты повторяются, сократите промпт или уменьшите число входных изображений.
Дополнительные вопросы о gpt-image-2
Когда вышла gpt-image-2?
По официальному changelog OpenAI, GPT Image 2 вышла 21 апреля 2026 года, снапшот по умолчанию — gpt-image-2-2026-04-21. Позже, 8 сентября 2026 года, OpenAI выпустила GPT Image 2.5 Sunburst и GPT Image 2.5 Flare (по состоянию на 2026-10-15).
Какие размеры и уровни качества поддерживает gpt-image-2?
В официальном API OpenAI популярные размеры — 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 и auto, качество — low, medium, high или auto. Через /qcode-img/v1 в QCode size может быть auto, 1024x1024, 1024x1536, 1536x1024 или 2048x2048, quality — low, medium или high; другие размеры возвращают 422.
Может ли gpt-image-2 вернуть ссылку на изображение?
Нет. Официальный Image API возвращает изображение в base64, и эндпоинт QCode тоже отдаёт только b64_json; response_format=url вернёт 400. Декодируйте b64_json и сохраните файл или покажите изображение на веб-странице как data URL.
Можно ли получить в gpt-image-2 PNG с прозрачным фоном?
В официальном API OpenAI — да: по changelog, с 20 августа 2026 года gpt-image-2 в предварительном режиме поддерживает background=transparent при выводе в png или webp. Через /qcode-img/v1 в QCode это по состоянию на 2026-10-15 не поддерживается: transparent вернёт 400, а background может быть только auto или opaque.
Что делать, если запросы к gpt-image-2 постоянно падают по тайм-ауту?
Сначала увеличьте тайм-аут клиента до 180 секунд и больше. OpenAI отмечает, что сложные промпты могут обрабатываться до 2 минут, а документация QCode требует явно задать в SDK timeout не меньше 180 секунд, включая тайм-аут чтения промежуточного обратного прокси. 504 или тайм-аут клиента можно просто повторить; если это повторяется, сократите промпт или уменьшите число входных изображений.
Чем gpt-image-2 отличается от GPT Image 2.5?
Согласно официальному руководству OpenAI по генерации изображений (на 2026-10-20), GPT Image 2.5 Sunburst и Flare добавляют качество xhigh и max, а gpt-image-2 ограничен high. OpenAI рекомендует серию 2.5 для новых интеграций: Sunburst — для точности редактирования, Flare — для быстрой повседневной генерации высокого качества. Доступные в QCode модели изображений и их оплата указаны на /models.
Как оплатить и начать пользоваться QCode для gpt-image-2?
Зарегистрируйтесь в QCode, пополните баланс, выберите тариф и создайте API-ключ в консоли. В юанях доступны Alipay и WeChat Pay, в долларах — карты Visa / Mastercard / AMEX, Apple Pay и Google Pay, а также криптовалюта (много монет и сетей); зарубежная карта не нужна, всё оформляется самостоятельно; в русскоязычном интерфейсе также есть российские банковские карты и СБП. Не хотите месячный тариф? «Разовые пакеты» начинаются с $4: разовый объём, который нужно израсходовать за 7 дней. Если у вас уже есть личный тариф и квоты не хватает, докупите бустер-пакет. gpt-image-2 тарифицируется за число выходных изображений: $0.30 за изображение, подробнее на /models.
Подробнее о GPT Image 2
Тариф QCode — единая подписка для нескольких CLI, гибкие тарифы подписки