GPT Image 2 API: цена и оплата, нативное 4K за $0.03

В LaoZhang API способ оплаты gpt-image-2 — за вызов или по токенам — определяют группа и режим оплаты токена, а не поле model. Это руководство для уже работающих интеграций GPT Image 2; новые проекты лучше начинать с GPT Image 2.5. gpt-image-2-vip стоит $0.03 за изображение при любом размере от 1K до 4K и любом качестве от low до high. 4K создаётся нативно в запрошенном размере, без апскейла. Ни в одной группе нет лимита параллельности и частоты запросов, а запросы автоматически переключаются между несколькими upstream-маршрутами.

Выбор группы токена

Группа токена	Режим оплаты	ID модели	`size` и `quality`	Цена
`default`	Оплата за вызов	`gpt-image-2`	Не поддерживаются	$0.03 за вызов
`default`	Оплата за вызов	`gpt-image-2-vip`	Размеры 1K, 2K и 4K; `low`, `medium`, `high`	$0.03 за вызов
`OpenAI Official` (раньше Sora2Official)	Оплата по использованию	`gpt-image-2`	Поддерживаются	По токенам, см. ниже
`OpenAI Official Enterprise` (раньше GPTImage2 Sora2 Enterprise)	Оплата по использованию	`gpt-image-2`	Поддерживаются	По токенам, см. ниже

Какой маршрут стоит за каждой строкой:

gpt-image-2 в default: стандартный маршрут с оплатой за вызов
gpt-image-2-vip в default: маршрут VIP
OpenAI Official: пересылка через официальный API по цене OpenAI
OpenAI Official Enterprise: пересылка через официальный API по цене OpenAI плюс 20%

Ни в одной группе у отдельного ключа нет ограничений RPM (запросов в минуту), IPM (изображений в минуту) и параллельности; ответ 429 означает нехватку мощности апстрима, см. Параллельность и 429. Ответы апстрима не 200 не тарифицируются. Режим оплаты задаётся при создании токена: «оплата за вызов» (按次计费) или «оплата по использованию» (按量计费). Публичные цены указаны на 24 сентября 2026 года; актуальный список — в разделе Цены на API моделей ИИ. Все четыре маршрута используют POST /v1/images/generations для генерации по тексту и POST /v1/images/edits для редактирования по изображению. Обе модели также доступны в другой группе изображений, название которой показывает консоль. В GPT Image 2.5 добавлены варианты Flare и Sunburst и уровни качества xhigh и max.

Не указывайте название группы в поле model. Группа выбирается при создании токена, а в теле запроса по-прежнему остаётся model="gpt-image-2". Изменив model, токен с оплатой за вызов не превратить в токен с оплатой по использованию.

Какой маршрут выбрать

Задача	Что использовать
Оплата за вызов	Токен группы `default` с оплатой за вызов; если нужны `size` или `quality` — `gpt-image-2-vip`
Оплата по токенам с параметрами OpenAI	Токен группы `OpenAI Official` или `OpenAI Official Enterprise` с оплатой по использованию и `model="gpt-image-2"`
Уже работающий код с `gpt-image-2-vip`	Оставьте токен с оплатой за вызов и продолжайте передавать `size` и `quality`
Уже работающий код для OpenAI GPT Image 2	Токен с пересылкой через официальный API и оплатой по использованию; тело запроса и `model="gpt-image-2"` не меняйте
Списания не совпадают с ожиданиями	Прежде чем менять запрос, проверьте группу токена в консоли

Цены при пересылке через официальный API

В группе OpenAI Official модель gpt-image-2 тарифицируется по фактическому расходу токенов по официальным ставкам OpenAI:

Расход	Цена за 1M токенов
Текст на входе	$5
Кэшированный текст на входе	$1.25
Изображения на входе	$8
Кэшированные изображения на входе	$2
Изображения на выходе	$30

Группа OpenAI Official Enterprise стоит на 20% больше официальной цены (множитель группы 1.2× к этим ставкам). Множитель для своего токена проверьте в консоли, а за корпоративными условиями обращайтесь в поддержку.

Параметры по маршрутам

gpt-image-2 в группе default

Стандартный маршрут с оплатой за вызов и самое простое подключение. Он не принимает size и quality, поэтому не передавайте их.

gpt-image-2-vip в группе default

Этот маршрут подходит, если нужна оплата за вызов и контроль размера и качества:

size: распространённые значения — 1024x1024 и 2048x2048.
Размеры 4K: 3840x2160 (альбомная ориентация), 2160x3840 (портретная) или 2880x2880 (квадрат). 2K и 4K создаются нативно.
quality: low, medium или high.
Размер и качество не меняют цену в $0.03 за вызов.
Обычно ответ содержит data[0].b64_json, изредка — ссылку на изображение. Передайте response_format: "b64_json", чтобы всегда получать Base64, или url, чтобы получить ссылку с ограниченным сроком действия.
При редактировании повторите поле image[], чтобы отправить несколько референсных изображений в одном запросе.
mask не поддерживается: модель ненадёжно ограничивает правку областью маски.
Прозрачный фон не поддерживается, и background="transparent" возвращает 400. Для прозрачного PNG используйте модели GPT Image 2.5 -vip, раздел «Прозрачный PNG».

Чем выше качество, тем дольше генерация, поэтому для превью и пакетных тестов берите low или medium, а для финальных материалов — high. Если нужна маршрутизация через официальные ключи и полный набор параметров OpenAI, используйте группу с пересылкой через официальный API.

gpt-image-2 в группах с пересылкой через официальный API

OpenAI Official — группа с пересылкой через официальный API по официальной цене OpenAI. OpenAI Official Enterprise — корпоративная группа с пересылкой по официальной цене плюс 20% (множитель группы 1.2×). Первую обслуживают ключи OpenAI вместе с Azure OpenAI, вторую — только ключи OpenAI.

Создайте новый токен с оплатой по использованию в разделе Управление токенами.
Выберите группу OpenAI Official или OpenAI Official Enterprise.
Оставьте model="gpt-image-2" и своё официальное тело запроса. Замените только базовый URL и API-ключ.

Используйте параметры OpenAI и проверяйте каждое передаваемое поле на выбранном маршруте. Распространённые значения:

Параметр	Значения
`size` (квадрат)	`1024x1024`, `2048x2048`
`size` (альбомная ориентация)	`1536x1024`, `2048x1152`, `3840x2160`
`size` (портретная ориентация)	`1024x1536`, `2160x3840`
`size` (автоматически)	`auto`
`quality`	`low`, `medium`, `high`, `auto`

Подготовка

Задайте ключ из группы, которая соответствует выбранному маршруту, и OpenAI-совместимый базовый URL:

export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"  # замените на свой API-ключ LaoZhang API
export BASE_URL="https://api.laozhang.ai/v1"

Базовый URL должен заканчиваться на /v1; не добавляйте к нему путь конкретной модели. Примеры сохраняют каждый ответ в JSON-файл, а затем извлекают изображение небольшим скриптом на Python.

Генерация изображения

Генерация через gpt-image-2 (группа default)

Не передавайте size и quality:

curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Чистый предметный рендер белой керамической кружки на сером столе, мягкий естественный свет, минималистичный фон"
  }' \
  -o gpt-image-2.json

Генерация через gpt-image-2-vip

Передайте size и quality в теле запроса:

curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-vip",
    "prompt": "Чистый предметный рендер белой керамической кружки на сером столе, мягкий естественный свет, минималистичный фон",
    "size": "2048x2048",
    "quality": "high"
  }' \
  -o gpt-image-2-vip.json

Генерация через gpt-image-2 с пересылкой через официальный API

Используйте токен с оплатой по использованию из группы OpenAI Official или OpenAI Official Enterprise:

curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Чистый предметный рендер белой керамической кружки на сером столе, мягкий естественный свет, минималистичный фон",
    "size": "1536x1024",
    "quality": "high"
  }' \
  -o gpt-image-2-official.json

Сохранение изображения

Images API возвращает каждое изображение в массиве data[] в одном из двух полей:

b64_json: данные изображения в Base64; значение может начинаться с префикса data:image/...;base64, или не иметь выравнивания =
url: ссылка для скачивания изображения

Скрипт ниже обрабатывает все эти случаи. Сохраните его как save_images.py:

save_images.py

import base64
import json
import sys
import urllib.request
from pathlib import Path

response_file, stem = sys.argv[1], sys.argv[2]
response = json.loads(Path(response_file).read_text())
if not response.get("data"):
    sys.exit(f"В {response_file} нет изображения: {response}")

for number, item in enumerate(response["data"], start=1):
    if item.get("b64_json"):
        # Убираем необязательный префикс data:image/...;base64, и восстанавливаем выравнивание.
        value = item["b64_json"].split(",", 1)[-1]
        image = base64.b64decode(value + "=" * (-len(value) % 4))
    else:
        with urllib.request.urlopen(item["url"], timeout=120) as download:
            image = download.read()
    if image.startswith(b"\x89PNG"):
        extension = "png"
    elif image[:4] == b"RIFF" and image[8:12] == b"WEBP":
        extension = "webp"
    else:
        extension = "jpg"
    path = Path(f"{stem}-{number}.{extension}")
    path.write_bytes(image)
    print(f"Сохранено: {path}")

Запустите его для любого из ответов выше:

python3 save_images.py gpt-image-2-vip.json mug

Скрипт выведет строку вроде Сохранено: mug-1.png. Откройте изображение и проверьте его размеры, затем сверьте модель, группу и списание в журнале вызовов.

Редактирование изображения

Положите локальный файл source.png в текущую папку. Редактирование отправляется как multipart-загрузка: передайте файл через -F, а тип содержимого cURL выставит сам.

Редактирование через gpt-image-2 (группа default)

curl --fail-with-body "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Используй переданное изображение как исходное. Сохрани объект, композицию и текст. Измени только цвет наклейки на красный и добавь кружке очень тонкий золотой ободок." \
  -F "image=@source.png" \
  -o gpt-image-2-edit.json

python3 save_images.py gpt-image-2-edit.json edit

Редактирование через gpt-image-2-vip

curl --fail-with-body "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2-vip" \
  -F "prompt=Используй переданное изображение как исходное. Сохрани объект, композицию и текст. Измени только цвет наклейки на синий." \
  -F "image=@source.png" \
  -o gpt-image-2-vip-edit.json

python3 save_images.py gpt-image-2-vip-edit.json vip-edit

Редактирование через gpt-image-2 с пересылкой через официальный API

При пересылке через официальный API редактирование идёт через /v1/images/edits с параметрами OpenAI:

curl --fail-with-body "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Используй переданное изображение как исходное. Сохрани объект, композицию и текст. Измени только цвет наклейки на зелёный." \
  -F "image=@source.png" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -o gpt-image-2-official-edit.json

python3 save_images.py gpt-image-2-official-edit.json official-edit

Проверьте на сохранённом изображении и запрошенное изменение, и детали, которые должны были остаться прежними.

Частые вопросы

Почему gpt-image-2 ведёт себя по-разному в разных группах?

Маршрут определяет группа токена: в default модель gpt-image-2 тарифицируется за вызов, а в OpenAI Official и OpenAI Official Enterprise — по токенам с пересылкой через официальный API. Маршруты сравниваются в разделе «Выбор группы токена» в начале страницы. Если списание не совпадает с ожиданиями, проверьте группу и сумму каждого запроса в журнале вызовов.

Принимает ли gpt-image-2 в группе default параметр size?

Нет. Для оплаты за вызов с выбором размера используйте gpt-image-2-vip, а для размеров OpenAI — gpt-image-2 в группе с пересылкой через официальный API.

Может ли gpt-image-2-vip выдавать изображения 4K?

Да, причём 4K нативное: изображение сразу генерируется в запрошенном size, а не рендерится в малом размере с последующим увеличением. Используйте 3840x2160 для альбомной ориентации, 2160x3840 для портретной или 2880x2880 для квадрата. 4K в высоком качестве стоит те же $0.03 за вызов, что и 1K.

Где получить GPT Image 2 API дешевле?

Используйте gpt-image-2-vip в LaoZhang API: $0.03 за вызов без доплаты за 4K или high, без аккаунта OpenAI, без лимита параллельности и частоты запросов. Если нужны параметры, полностью совпадающие с API OpenAI, берите gpt-image-2 в группе с пересылкой через официальный API: оплата идёт по токенам по ценам OpenAI. Новые интеграции можно сразу начинать с моделей GPT Image 2.5 -vip за те же $0.03.

Как перенести официальный код OpenAI?

Оставьте официальное тело запроса и замените только токен и базовый URL:

Создайте токен с оплатой по использованию в группе OpenAI Official или OpenAI Official Enterprise.
Оставьте model="gpt-image-2" и смените базовый URL на https://api.laozhang.ai/v1.
Используйте свой API-ключ LaoZhang API.

Почему при пересылке не работают response_format и input_fidelity?

Уберите оба поля. По правилам OpenAI модели GPT Image всегда возвращают изображение в Base64 и не поддерживают response_format, а gpt-image-2 автоматически обрабатывает каждое входное изображение с высокой точностью, поэтому input_fidelity изменить нельзя. Код, перенесённый с DALL·E или ранних моделей GPT Image, часто всё ещё передаёт эти поля. Если нужна ссылка на изображение, декодируйте b64_json и загрузите файл в собственное хранилище, а не ждите URL от API.

Почему правка при пересылке стоит дороже генерации?

Референсные изображения тоже тарифицируются. gpt-image-2 всегда обрабатывает входные изображения с высокой точностью и считает их входными токенами изображений, поэтому правка с референсами может расходовать заметно больше входных токенов, чем генерация по тексту, и каждый дополнительный референс добавляет ещё. Выходные токены по-прежнему зависят от размера и качества. Оцените бюджет по полю usage в нескольких типичных запросах на редактирование, а фактическое списание сверьте в журнале вызовов. На маршрутах с оплатой за вызов референсы на цену не влияют.

Почему не декодируется b64_json?

Значение часто начинается с префикса data:image/png;base64, или не содержит выравнивания =. Скрипт из раздела «Сохранение изображения» обрабатывает оба случая. Если декодирование всё равно не удаётся, проверьте, не пришёл ли вместо изображения JSON с ошибкой.

Стоит ли переходить на GPT Image 2.5?

Существующие интеграции GPT Image 2 могут работать дальше. Для новых задач используйте GPT Image 2.5: модели -vip подключаются с оплатой за вызов так же, как gpt-image-2-vip, а модели с пересылкой через официальный API используют те же группы и запросы Images API, что и gpt-image-2 на этом маршруте. При пересылке через официальный API одно и то же значение quality в 2.5 может расходовать другое число токенов и занимать другое время, поэтому перед переходом проверьте свои рабочие промпты. ID моделей и параметры описаны в руководстве по GPT Image 2.5 и в его разделе «Частые вопросы».

Связанные материалы

GPT Image 2.5 — рекомендуется для новых интеграций
Images API — общий формат запросов и ответов
Сравнение API изображений — все модели изображений в одной таблице
Цены на API моделей ИИ — актуальные цены и группы
Журнал вызовов — модель, группа и списание по каждому запросу

Начало работы

API генерации и редактирования изображений

API генерации видео

API для текста

GPT Image 2 API: цена и оплата, нативное 4K за $0.03

Выбор группы токена

Какой маршрут выбрать

Цены при пересылке через официальный API

Параметры по маршрутам

gpt-image-2 в группе default

gpt-image-2-vip в группе default

gpt-image-2 в группах с пересылкой через официальный API

Подготовка

Генерация изображения

Генерация через gpt-image-2 (группа default)

Генерация через gpt-image-2-vip

Генерация через gpt-image-2 с пересылкой через официальный API

Сохранение изображения

Редактирование изображения

Редактирование через gpt-image-2 (группа default)

Редактирование через gpt-image-2-vip

Редактирование через gpt-image-2 с пересылкой через официальный API

Частые вопросы

Почему gpt-image-2 ведёт себя по-разному в разных группах?

Принимает ли gpt-image-2 в группе default параметр size?

Может ли gpt-image-2-vip выдавать изображения 4K?

Где получить GPT Image 2 API дешевле?

Как перенести официальный код OpenAI?

Почему при пересылке не работают response_format и input_fidelity?

Почему правка при пересылке стоит дороже генерации?

Почему не декодируется b64_json?

Стоит ли переходить на GPT Image 2.5?

Связанные материалы

Источники

​Выбор группы токена

​Какой маршрут выбрать

​Цены при пересылке через официальный API

​Параметры по маршрутам

​gpt-image-2 в группе default

​gpt-image-2-vip в группе default

​gpt-image-2 в группах с пересылкой через официальный API

​Подготовка

​Генерация изображения

​Генерация через gpt-image-2 (группа default)

​Генерация через gpt-image-2-vip

​Генерация через gpt-image-2 с пересылкой через официальный API

​Сохранение изображения

​Редактирование изображения

​Редактирование через gpt-image-2 (группа default)

​Редактирование через gpt-image-2-vip

​Редактирование через gpt-image-2 с пересылкой через официальный API

​Частые вопросы

​Почему gpt-image-2 ведёт себя по-разному в разных группах?

​Принимает ли gpt-image-2 в группе default параметр size?

​Может ли gpt-image-2-vip выдавать изображения 4K?

​Где получить GPT Image 2 API дешевле?

​Как перенести официальный код OpenAI?

​Почему при пересылке не работают response_format и input_fidelity?

​Почему правка при пересылке стоит дороже генерации?

​Почему не декодируется b64_json?

​Стоит ли переходить на GPT Image 2.5?

​Связанные материалы

​Источники

Выбор группы токена

Какой маршрут выбрать

Цены при пересылке через официальный API

Параметры по маршрутам

gpt-image-2 в группе default

gpt-image-2-vip в группе default

gpt-image-2 в группах с пересылкой через официальный API

Подготовка

Генерация изображения

Генерация через gpt-image-2 (группа default)

Генерация через gpt-image-2-vip

Генерация через gpt-image-2 с пересылкой через официальный API

Сохранение изображения

Редактирование изображения

Редактирование через gpt-image-2 (группа default)

Редактирование через gpt-image-2-vip

Редактирование через gpt-image-2 с пересылкой через официальный API

Частые вопросы

Почему gpt-image-2 ведёт себя по-разному в разных группах?

Принимает ли gpt-image-2 в группе default параметр size?

Может ли gpt-image-2-vip выдавать изображения 4K?

Где получить GPT Image 2 API дешевле?

Как перенести официальный код OpenAI?

Почему при пересылке не работают response_format и input_fidelity?

Почему правка при пересылке стоит дороже генерации?

Почему не декодируется b64_json?

Стоит ли переходить на GPT Image 2.5?

Связанные материалы

Источники