> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Как продолжать работу с gpt-image-2 и gpt-image-2-vip в LaoZhang API: группа токена и режим оплаты, высокое качество без лимитов запросов, генерация и редактирование.

В LaoZhang API способ оплаты `gpt-image-2` — за вызов или по токенам — определяют группа и режим оплаты токена, а не поле `model`. Это руководство для уже работающих интеграций GPT Image 2; новые проекты лучше начинать с [GPT Image 2.5](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5.md).

`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](https://docs.laozhang.ai/ru/faq/api-concurrency.md). Ответы апстрима не 200 не тарифицируются.

Режим оплаты задаётся при создании токена: **«оплата за вызов»** (按次计费) или **«оплата по использованию»** (按量计费). Публичные цены указаны на 24 сентября 2026 года; актуальный список — в разделе [Цены на API моделей ИИ](https://docs.laozhang.ai/ru/models.md).

Все четыре маршрута используют `POST /v1/images/generations` для генерации по тексту и `POST /v1/images/edits` для редактирования по изображению. Обе модели также доступны в другой группе изображений, название которой показывает консоль. В GPT Image 2.5 добавлены варианты Flare и Sunburst и уровни качества `xhigh` и `max`.

> [!WARNING]
>
> Не указывайте название группы в поле `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× к этим ставкам). Множитель для своего токена проверьте в [консоли](https://api.laozhang.ai/account/pricing), а за корпоративными условиями обращайтесь в поддержку.

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

### 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`](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5), раздел «Прозрачный PNG».

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

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

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

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

1. Создайте новый токен с оплатой по использованию в разделе [Управление токенами](https://api.laozhang.ai/token).
2. Выберите группу `OpenAI Official` или `OpenAI Official Enterprise`.
3. Оставьте `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:

```bash theme={null}
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`:

```bash theme={null}
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` в теле запроса:

```bash theme={null}
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`:

```bash theme={null}
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`:

```python save_images.py theme={null}
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}")
```

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

```bash theme={null}
python3 save_images.py gpt-image-2-vip.json mug
```

Скрипт выведет строку вроде `Сохранено: mug-1.png`. Откройте изображение и проверьте его размеры, затем сверьте модель, группу и списание в [журнале вызовов](https://api.laozhang.ai/log).

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

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

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

```bash theme={null}
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

```bash theme={null}
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:

```bash theme={null}
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. Маршруты сравниваются в разделе «Выбор группы токена» в начале страницы. Если списание не совпадает с ожиданиями, проверьте группу и сумму каждого запроса в [журнале вызовов](https://api.laozhang.ai/log).

### Принимает ли 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`](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5) за те же \$0.03.

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

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

1. Создайте токен с оплатой по использованию в группе `OpenAI Official` или `OpenAI Official Enterprise`.
2. Оставьте `model="gpt-image-2"` и смените базовый URL на `https://api.laozhang.ai/v1`.
3. Используйте свой 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` в нескольких типичных запросах на редактирование, а фактическое списание сверьте в [журнале вызовов](https://docs.laozhang.ai/en/faq/call-logs.md). На маршрутах с оплатой за вызов референсы на цену не влияют.

### Почему не декодируется 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](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5.md) и в его разделе «Частые вопросы».

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

* [GPT Image 2.5](https://docs.laozhang.ai/ru/api-capabilities/gpt-image-2-5.md) — рекомендуется для новых интеграций
* [Images API](https://docs.laozhang.ai/ru/api-reference/images.md) — общий формат запросов и ответов
* [Сравнение API изображений](https://docs.laozhang.ai/ru/api-capabilities/image-generation-guide.md) — все модели изображений в одной таблице
* [Цены на API моделей ИИ](https://docs.laozhang.ai/ru/models.md) — актуальные цены и группы
* [Журнал вызовов](https://docs.laozhang.ai/en/faq/call-logs.md) — модель, группа и списание по каждому запросу

## Источники

* [OpenAI GPT Image 2](https://developers.openai.com/api/docs/models/gpt-image-2)
* [Руководство OpenAI по генерации изображений](https://developers.openai.com/api/docs/guides/image-generation)
* [Справочник OpenAI Images API](https://developers.openai.com/api/reference/resources/images)
* [Модели и цены LaoZhang API в консоли](https://api.laozhang.ai/account/pricing)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.