> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GPT-image-2 Официальный vs реверс
> Сравните gpt-image-2 (официальный) с сестринскими моделями, полученными методом реверс-инжиниринга, gpt-image-2-all и gpt-image-2-vip: тип канала, цены, эндпоинты, форматы загрузки и вывода, позиционирование по скорости и качеству, соответствие prompt — выберите подходящую модель.
## Кратко
| Если вам нужно | Выберите |
| ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| **`quality` регулятор / инпейнтинг по маске / фиксированные размеры, 4K / строгое соответствие полей OpenAI-API** | `gpt-image-2` (официальный, тарификация по token) |
| **Предсказуемая фиксированная цена \$0.03 за изображение + быстрый результат (скорость — преимущество)** | `gpt-image-2-all` (Reverse, ветка ChatGPT web, \~90s) |
| **Предсказуемая фиксированная цена \$0.03 за изображение + иногда более высокое качество (если не спешите)** | `gpt-image-2-vip` (Reverse, ветка Codex, \~120–200s) |
Все три модели **в основе используют OpenAI gpt-image-2**. Различия — в природе канала (официальный прямой vs реверс-инжиниринговый), модели тарификации и детализации параметров.
**Два reverse-собрата (-all / -vip)**: Столбец «Реверс» на этой странице охватывает **оба** `gpt-image-2-all` и `gpt-image-2-vip` — у них **идентичный формат вызова** и та же фиксированная цена \$0.03 за изображение. Разница сейчас в **скорости и качестве**:
* `gpt-image-2-all`: ветка ChatGPT web, **\~90s** генерация — **скорость — преимущество**
* `gpt-image-2-vip`: ветка Codex, **\~120–200s** генерация — медленнее, но **иногда более высокое качество**
* Оба: без `quality`, без `n`, без инпейнтинга по маске
⚠️ **Параметр `-vip`'s `size` сейчас не работает** (с 2026-06-23, из-за изменения правила генерации Codex; output фиксирован на adaptive 1K, срок восстановления неизвестен) — для фиксированных размеров / 4K используйте официальный `gpt-image-2`. То же касается уровней `quality` или инпейнтинга по маске.
**О текущих скоростях**: генерация `-all` / `-vip` сейчас **медленнее, чем на старте** из-за **колебаний вычислительных ресурсов на стороне upstream OpenAI** — это затрагивает всех пользователей reverse-канала, а не только APIYI; пул аккаунтов и операции у нас в норме. Установите тайм-ауты клиента на 300s+ и закладывайте больший запас для сложных prompt.
## Полная таблица сравнения
| Параметр | **gpt-image-2-all / -vip** (реверс, экономичный) | **gpt-image-2** (официальный) |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **Название модели** | `gpt-image-2-all` (самый быстрый) / `gpt-image-2-vip` (в приоритете качество, когда не торопитесь) | `gpt-image-2` |
| **Природа канала** | `-all`: реверс-инжиниринговая линия ChatGPT web
`-vip`: реверс-инжиниринговая линия Codex | Официальный прямой (OpenAI Images API) |
| **Тарифы** | **За вызов**: фиксированные \$0.03/вызов (обе модели, одна цена) | **По token**: соответствует официальному; около **85% от цены по прайсу** после бонусов за пополнение APIYI |
| **Типичная стоимость/изображение** | \$0.03 (независимо от размера / качества / модели) | Обычно **\$0.03 – \$0.2** (зависит от длины prompt, размера, качества) |
| **Группа token** | По умолчанию | По умолчанию |
| **Тип token** | Работают и **за вызов**, и **Token-priority** | Только **Token-priority** (для этой модели используется тарификация по token; token по модели за вызов будут отклонены) |
| **Рекомендуемый endpoint** | **`/v1/images/generations` + `/v1/images/edits`** (более стабильно, больше upstream-поставок, и тот же код, что у официального — просто меняйте имя `model`, чтобы переключаться во время турбулентности risk-control) | `/v1/images/generations` + `/v1/images/edits` |
| **Формат загрузки** | multipart file (endpoint edits) | multipart file (endpoint edit) |
| **Формат вывода** | `b64_json` (по умолчанию, **сырой base64 без префикса**, подтверждено в 2026-07; в более ранних версиях префикс присутствовал) или `url` (R2 CDN) | `b64_json` (**сырой base64, без префикса**) |
| **Количество reference image** | Несколько | **Макс. 16** (`image[]`) |
| **Inpainting по маске** | ❌ Не поддерживается | ✅ Поддерживается (требуется alpha channel) |
| **Соответствие prompt** | Хорошее | **Отличное** |
| **Скорость генерации** | `-all`: \~**90 секунд** (преимущество — скорость)
`-vip`: \~**120–200 секунд** (медленнее, но иногда качество выше)
📌 Сейчас медленнее, чем на запуске — вычисления upstream OpenAI, а не проблема на стороне APIYI | \~**100-120 секунд**, сложные запросы + 4K могут занять 3-5 минут |
| **Тенденция качества** | `-all`: хорошее
`-vip`: **иногда выше** (линия Codex, иногда лучше детализация) | Стабильное, и `quality=high` выжимает из него максимум |
| **Параметр `size`** | `-all`: ❌ Не принимается (описывайте в prompt)
`-vip`: ⚠️ **Сейчас сломан** (зафиксирован на adaptive 1K с 2026-06-23, срок восстановления не указан) | ✅ Любой допустимый пользовательский размер |
| **Поддержка 4K** | `-all`: ❌
`-vip`: ⚠️ Недоступно, пока сломан `size` (фиксированный 1K) | ✅ Включая `3840×2160` |
| **Типичные размеры вывода** | `-all`: 16:9 -> 1672×941, 9:16 -> 941×1672, 1:1 -> 1254×1254 (adaptive)
`-vip`: adaptive 1K (пока `size` сломан; прежняя [таблица из 30 размеров](/ru/api-capabilities/gpt-image-2-vip/overview#supported-sizes-full-30-size-table) не действует) | 8 preset + любой допустимый пользовательский размер |
| **Параметр `quality`** | ❌ Обе reverse-модели отклоняют его (не передавайте) | ✅ `low` / `medium` / `high` / `auto` |
| **Параметр `n`** | ❌ Обе reverse-модели отклоняют его (1 изображение на вызов) | ✅ Поддерживается |
| **Прозрачный фон** | — | ❌ Не поддерживается (ошибки `background: transparent`) |
| **Prompt на китайском** | ✅ Нативно | ✅ Нативно |
| **Рендеринг текста** | Высокая точность | Высокая точность (наиболее сильна на уровне `high`) |
| **API docs** | [Обзор GPT-Image-2-All](/ru/api-capabilities/gpt-image-2-all/overview) / [Обзор GPT-Image-2-VIP](/ru/api-capabilities/gpt-image-2-vip/overview) | [Обзор GPT-Image-2](/ru/api-capabilities/gpt-image-2/overview) |
🔑 **Создание и управление API token**: [https://api.apiyi.com/token](https://api.apiyi.com/token)\
При создании token в консоли выберите группу (`Default` подойдет) и тип token (**За вызов** / **Token-priority**). **Для вызова `gpt-image-2` (официальный) требуется token типа «Token-priority»** — token по модели за вызов будут отклонены из-за несовпадения режима тарификации.
## Когда выбирать каждый вариант
### Выбирайте `gpt-image-2-all` (реверс), когда
Стабильные \$0.03/изображение без уровня размера/качества. **Идеально для пакетного производства с жесткими потолками затрат** (инфографика, маркетинговые материалы, миниатюры для e-commerce).
Генерация \~90с — **немного быстрее**, чем и `-vip`, и официальная версия. **Лучше UX в реальном времени.**
Стандартный формат Images API — **тот же код**, что и `-vip`, и официальный релей `gpt-image-2`; переключайтесь или откатывайтесь, меняя имя `model`.
Нативная поддержка prompt на китайском языке, отличное отображение текста для вывесок / постеров / инфографики — **отлично подходит для создания контента для китайской аудитории**.
### Выбирайте `gpt-image-2-vip` (реверс, с упором на качество), когда
Детализация в линейке Codex **иногда лучше, чем у `-all`** — для демонстрационных изображений, когда вы не спешите и хотите немного более высокое качество по той же фиксированной цене реверс-канала.
Генерация \~**120–200с**, медленнее, чем `-all` — выбирайте, когда можете принять более долгое ожидание ради более высокого потолка.
Идентичная структура запроса к `-all` — **одна кодовая база переключается между обеими моделями** путем замены имени `model` в зависимости от вашего выбора между скоростью / качеством.
Та же фиксированная \$0.03/изображение, что и у `-all` — расходы на пакетное производство остаются ограниченными сверху.
**Прежнее преимущество `-vip` в виде «заблокированных размеров / 4K» сейчас не действует**: параметр `size` сломан с 2026-06-23 (изменение правил генерации Codex; вывод фиксирован на адаптивном 1K, сроков восстановления нет). Для ключевых промо-изображений e-commerce, шаблонов постеров, обоев 4K и любых **задач с заблокированным размером / 4K используйте официальный `gpt-image-2`**.
### Выбирайте `gpt-image-2` (официальный), когда
`quality` поддерживает low/medium/high/auto. **Используйте `low` для черновиков, чтобы сэкономить; `high` для финалов печатного качества** — только в official; оба reverse-модели это отклоняют.
Поддерживается маска alpha-канала — **точно изменяйте область, сохраняя остальное**. Оба reverse-модели этого не поддерживают.
`size` принимает любое допустимое разрешение (включая 4K). Хотя `size` в reverse-канале сломан, **любая задача с точным размером или 4K идет через официальный вариант**.
Проходит через официальный Images API — поля и поведение идентичны официальной версии OpenAI. **Существующий код / системы на базе OpenAI SDK мигрируют без каких-либо изменений** и остаются стабильными в долгосрочной перспективе.
## Подробные ключевые различия
### 1. Нюанс формата b64\_json (ловушка при миграции!)
Как подтверждено в июле 2026 года, обе модели теперь возвращают **raw base64 (без префикса `data:`)** — но `gpt-image-2-all` раньше включал префикс, поэтому самый безопасный общий код сначала проверяет его:
```python theme={null}
# Universal pattern: detect the prefix before processing — works for both models
b64 = resp["data"][0]["b64_json"]
if b64.startswith("data:"): # handles historical prefixed responses
b64 = b64.split(",", 1)[1]
with open("out.png", "wb") as f:
f.write(base64.b64decode(b64)) # ✅ write file
img_tag = f'
' # ✅ browser render
```
При переключении между ними **код обработки `b64_json` должен измениться**, иначе вы получите поврежденный data URL или ошибку декодирования.
### 2. Управление разрешением
**gpt-image-2-all** (в prompt):
```
"Landscape 16:9 cinematic, old lighthouse at sunset" → ~1672×941
"Portrait 9:16 phone wallpaper, cyberpunk city" → ~941×1672
"1024×1024 square logo, minimalist cat line art" → ~1254×1254
```
**gpt-image-2-vip** (`size` сейчас сломан, начиная с 2026-06-23):
Раньше он принимал 30 явных размеров (включая 4K), но после изменения правила генерации Codex **параметр `size` сломан, и вывод фиксирован на adaptive 1K**, без ETA на восстановление. Пока что описывайте композицию в prompt так же, как `-all`; **для точных размеров / 4K используйте официальный `gpt-image-2`**.
**gpt-image-2** (параметр `size` строгий + уровни `quality`):
```python theme={null}
client.images.generate(
model="gpt-image-2",
prompt="...",
size="2048x1152", # ✅ output exactly this
quality="high" # official-only
)
```
### 3. Различия в формате загрузки / вывода
| Операция | gpt-image-2-all | gpt-image-2 |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| **Загрузка референса** | multipart `image` поле file (эндпоинт edits) | multipart `image[]` поле file |
| **Получение результата** | По умолчанию `b64_json` (raw base64, проверено 2026-07); явный `response_format: "url"` возвращает ссылку R2 CDN (**срок действия 24h**) | `b64_json` (**raw base64**, требуется декодирование) |
| **Объединение нескольких изображений** | Повторяйте поле `image` в эндпоинте edits | массив `image[]`, **макс. 16** |
### 4. Ориентировочная стоимость
| Сценарий | gpt-image-2-all / -vip | gpt-image-2 |
| --------------------------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------- |
| Черновик 1024×1024 | \$0.03 | \~\$0.006 (низкий) |
| 1024×1024, среднее качество | \$0.03 | \~\$0.053 (средний) |
| 1024×1024, высокое качество | \$0.03 | \~\$0.211 (высокий) |
| 2048×1152, высокое качество | \$0.03 | \~\$0.20+ (с тарификацией по token) |
| 3840×2160 4K, высокое качество | — (ни одна reverse-модель не может нацелиться на 4K, пока `size` сломан) | С тарификацией по token, **значительно выше, чем 1K** |
| Редактирование / объединение нескольких изображений | \$0.03 | Входные token резко растут, один вызов может достичь \$0.1+ |
**Итог**: Для пакетных / низкокачественных нагрузок reverse-канал не всегда дешевле (1K low на официальном tier на самом деле дешевле). **Диапазон среднего и высокого качества** — это оптимальная зона reverse-канала за \$0.03. Выбирайте официальный (с тарификацией по token), когда вам нужны **`quality` tiers / mask inpainting / locked sizes, 4K / strict OpenAI-API field parity**.
## Настройки клиента
| Setting | gpt-image-2-all / -vip | gpt-image-2 |
| ------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| **Тайм-аут (с запасом)** | `-all`: **300s** (обычно \~90s)
`-vip`: **300s** (обычно 120–200s) | **360s** (4K с высоким качеством на практике занимает 3–5 минут) |
| **Стратегия повторных попыток** | Экспоненциальный backoff при 5xx / timeout, максимум 2 повтора | То же самое |
| **Параллельные запросы** | 1 изображение за вызов — отправляйте параллельные запросы для нескольких | 1 изображение за вызов — отправляйте параллельные запросы для нескольких |
| **ID запроса** | заголовок ответа `request-id` | заголовок ответа `x-request-id` |
**Для всех трёх моделей: при редактировании изображений / объединении нескольких изображений сжимайте каждое входное изображение до менее чем 1.5MB** (качество JPEG 80-90 / уменьшенное разрешение). Спорадические ответы `shell_api_error` / `Unknown error` чаще всего вызываются слишком большими входными данными — сжатие заметно повышает успешность и снижает задержку. **Разрешение вывода не зависит от размера входных данных** — качество задается на стороне вывода (`size` + `quality` для официального релея; формулировкой prompt для `-all` и для `-vip`, пока его `size` сломан), а не размером входного файла.
## ЧаВо
**Да, настоятельно рекомендуется.** Для всех трех моделей сжимайте каждое входное изображение до **менее 1.5MB** (качество JPEG 80-90 / уменьшенное разрешение): спорадические `shell_api_error` / `Unknown error` ответы чаще всего вызываются слишком большими входными данными, а сжатие заметно повышает процент успешных вызовов и снижает задержку.
**Не беспокойтесь, что сжатие ухудшит качество** — разрешение результата не зависит от размера входного файла. Настройки «стороны вывода» различаются у этих трех моделей:
* `gpt-image-2-all`: управляется формулировкой prompt для композиции (см. таблицу проверенных формулировок на странице [-all обзора](/ru/api-capabilities/gpt-image-2-all/overview)) — `4K` / `8K` в prompt не учитываются
* `gpt-image-2-vip`: поле `size` **сейчас сломано** (зафиксировано на адаптивный 1K) — указывайте намерение композиции и в prompt тоже
* `gpt-image-2`: управляется `size` + `quality` (любой допустимый размер)
Итог: уменьшение входных данных лишь ускоряет работу — качество задается конфигурацией на стороне вывода, а не размером входного файла.
Да. Все три работают на канале по умолчанию — один и тот же API Key вызывает их без дополнительной настройки. Примечание: для вызова `gpt-image-2` (официальный) требуется token «Token-priority»; `-all` / `-vip` принимают любой тип token.
**Используйте OpenAI Images API** (`/v1/images/generations` для генерации изображений по тексту + `/v1/images/edits` для редактирования), по двум причинам:
1. **Стабильнее**: у канала Images API больше upstream-ресурсов, поэтому процент успешных вызовов выше
2. **Совместимо с официальным релеем для простого переключения**: способ вызова и формат параметров полностью совместимы с `gpt-image-2` официального релея — если на reverse-канале возникнут проблемы из-за risk-control, **просто замените имя `model`, чтобы переключиться на официальный релей** без каких-либо изменений кода
Также есть чатовый эндпоинт (`/v1/chat/completions`, **больше не рекомендуется**), который полезен только для многоходового итеративного редактирования или для прямой передачи онлайн-URL изображений. Учтите: если intent изображения неоднозначен, он может вернуть обычный текст вместо изображения (добавьте фиксированный префикс вроде «Generate an image:», чтобы усилить запрос). Полные параметры см. в [-all справочник по чат-API](/en/api-capabilities/gpt-image-2-all/chat-completions) / [-vip справочник по чат-API](/en/api-capabilities/gpt-image-2-vip/chat-completions).
Оба являются реверс-инжиниринговыми каналами по одной и той же фиксированной цене (\$0.03/image), с **идентичным форматом вызова** (поле `size` в `-vip` сейчас сломано, поэтому ни один из них не принимает `size`). Разница — **скорость против качества**:
* **Время генерации**: `-all` \~90s — **преимущество в скорости**; `-vip` \~120–200s. Сейчас медленнее, чем на запуске, из-за колебаний вычислительных ресурсов upstream OpenAI
* **Качество**: линия `-vip` (Codex) иногда дает более высокую детализацию рендеринга — для демонстрационных изображений, когда вы не торопитесь
Решение: нужен быстрый результат → `-all`; важнее качество и не спешите → `-vip`; нужны фиксированные размеры или 4K → официальный `gpt-image-2`. Подробности см. в [Обзор GPT-Image-2-VIP](/ru/api-capabilities/gpt-image-2-vip/overview).
Используйте официальный `gpt-image-2`. Параметр `size` у `-vip` сломан с 2026-06-23 (зафиксирован на adaptive 1K, ETA восстановления нет), поэтому ни одна из двух reverse-моделей сейчас не может точно управлять размерами вывода.
Возможности только официального: **любой допустимый размер (включая 4K)**, **уровни `quality`** (low/medium/high/auto), **инпейнтинг по маске** (маска alpha-канала), **строгое совпадение полей OpenAI API** (миграция без изменений для существующего кода OpenAI SDK). Тарификация по token.
* **Оставайтесь на OpenAI SDK / нужно строгое совпадение с официальным OpenAI, либо нужны фиксированные размеры / 4K**: выбирайте `gpt-image-2` (официальный). Уберите `input_fidelity`, избегайте `background: transparent`, остальное оставьте без изменений.
* **Снизить стоимость, нужен быстрый результат**: выбирайте `gpt-image-2-all` (reverse, \~90s).
* **Снизить стоимость, в приоритете качество и вы не спешите**: выбирайте `gpt-image-2-vip` (reverse, \~120–200s).
Да. Типичный вариант: **основная `-all` или `-vip`** (предсказуемая стоимость — выбирайте по предпочтению скорости / качества), **резервная `gpt-image-2`** (переключайтесь, когда нужны уровни `quality`, маска или фиксированные размеры). Форматы ответов reverse и official различаются — нормализуйте их на уровне бизнес-логики.
См. [Медленные загрузки CDN — что делать](/ru/faq/cdn-download-slow)
## Связанные документы
* [GPT-Image-2 Обзор](/ru/api-capabilities/gpt-image-2/overview) - Полная официальная документация по интеграции
* [GPT-Image-2-All Обзор](/ru/api-capabilities/gpt-image-2-all/overview) - Полная документация по интеграции для обратной линии ChatGPT-web (самый быстрый вывод)
* [GPT-Image-2-VIP Обзор](/ru/api-capabilities/gpt-image-2-vip/overview) - Полная документация по интеграции для обратной линии Codex (иногда качество выше; `size` currently broken)
* [Подробный разбор: запуск gpt-image-2](/en/news/gpt-image-2-launch) - Официальный выпуск
* [Подробный разбор: запуск gpt-image-2-all](/en/news/gpt-image-2-all-launch) - Запуск обратной версии
* [Сообщество: узлы Luck GPT-Image 2 для ComfyUI](/ru/scenarios/ecosystem/luckgpt2-comfyui) - Пакет узлов ComfyUI для нескольких моделей
* [Сообщество: навыки APIYI GPT-Image 2](/ru/scenarios/ecosystem/apiyi-gpt-image-skills) - Пакет навыков AI Agent для нескольких моделей
* [Акции на пополнение](/ru/faq/recharge-promotions) - Политика бонусов за пополнение