> ## 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-All Генерация/редактирование изображений

> Реверс-инжиниринговая модель генерации изображений GPT gpt-image-2-all (линейка веб-версии ChatGPT). Фиксированная тарификация $0.03/изображение за вызов, генерация примерно за 30–60 с. Поддерживает преобразование текста в изображение, редактирование с объединением нескольких изображений, редактирование на естественном языке, высокую точность рендеринга текста, удобна для prompt на китайском.

<Info>
  Все API генерации изображений являются **синхронными** — здесь нет task ID для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно тарифицируется. Установите для этой модели увеличенный timeout; см. [Основы и лучшие практики Image API](/ru/api-capabilities/image-api-best-practices).
</Info>

## Обзор

**gpt-image-2-all** — это **обратно-инженеренная модель генерации изображений GPT** (линейка веб-версии ChatGPT), доступная на платформе APIYI. При чрезвычайно конкурентной цене **\$0.03/image** за запрос она генерирует изображения примерно за **30–60 секунд** и поддерживает **text-to-image / редактирование одного изображения / слияние нескольких изображений / редактирование на естественном языке** — с высокой точностью рендеринга текста и нативной поддержкой китайских prompt.

<Note>
  **🎨 Основные моменты**: Надежный обратнo-инженеренный канал с фиксированной ставкой \$0.03/image. Не нужно беспокоиться о параметрах size/quality/n — просто опишите размер и стиль в prompt. Использует стандартные эндпоинты OpenAI Images API: `/v1/images/generations` (text-to-image) и `/v1/images/edits` (image editing).

  **Нужно зафиксировать размер вывода или 4K?** Переключитесь на сестринскую модель [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) — тот же формат вызова, только одно дополнительное поле `size`.
</Note>

<CardGroup cols={2}>
  <Card title="API генерации изображений по тексту" icon="wand-sparkles" href="/ru/api-capabilities/gpt-image-2-all/text-to-image">
    `/v1/images/generations` — генерируйте изображения по текстовым prompt.
  </Card>

  <Card title="API редактирования изображений" icon="image" href="/ru/api-capabilities/gpt-image-2-all/image-edit">
    `/v1/images/edits` — многочастичная загрузка с инструкциями по редактированию/слиянию.
  </Card>
</CardGroup>

## Ключевые особенности

<CardGroup cols={2}>
  <Card title="Очень выгодные цены" icon="dollar-sign">
    Фиксированная цена за каждый вызов: \$0.03/image, без уровней по разрешению, с предсказуемыми затратами
  </Card>

  <Card title="Качественный рендеринг текста" icon="type">
    Стабильный рендеринг китайского/английского текста, вывесок и текста на постерах — идеально для инфографики и маркетинговых материалов
  </Card>

  <Card title="Поддержка prompt на китайском" icon="languages">
    Нативное понимание описаний на китайском без перевода
  </Card>

  <Card title="Слияние нескольких изображений" icon="layers">
    Поддерживает несколько референсных изображений; prompt могут ссылаться на них как "image1/image2/image3"
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Быстрый результат" icon="bolt">
    \~30–60 с на генерацию — быстрее, чем и `gpt-image-2-vip`, и официальный релей `gpt-image-2`
  </Card>

  <Card title="Ускорение через R2 CDN" icon="cloud">
    Передавайте `response_format: "url"` явно для ссылок R2 CDN с глобальной доставкой с низкой задержкой
  </Card>

  <Card title="Редактирование на естественном языке" icon="message-circle">
    Редактируйте с помощью описаний в формате диалога, маски не требуются, поддерживается многоходовая итерация
  </Card>

  <Card title="Поддержка стандартных эндпоинтов" icon="plug">
    Совместимо со стандартными эндпоинтами OpenAI Images API `/images/generations` и `/images/edits`
  </Card>
</CardGroup>

## Тарифы

| Model             | Тарификация | Цена               | Вывод                  |
| ----------------- | ----------- | ------------------ | ---------------------- |
| `gpt-image-2-all` | За вызов    | **\$0.03 / image** | 1 изображение за вызов |

<Info>
  **Примечания по тарификации**:

  * Фиксированная цена; без уровней по разрешению, качеству или длине prompt
  * Неудачные запросы не тарифицируются (ошибки аутентификации, ошибки проверки параметров)
  * Для N изображений вызывайте API N раз параллельно
</Info>

<Tip>
  **Сестринская модель с той же ценой**: [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) (обратная линия Codex) — та же цена \$0.03/изображение, поддерживает 30 явных размеров (включая 4K), тот же формат вызова. Переключайтесь, когда вам нужны фиксированные размеры вывода.
</Tip>

## Настройка группы

`gpt-image-2-all` находится в группе `Default` — **дополнительная группа не нужна**. В reverse-канале сейчас стабильное наличие, поэтому здесь нет сценария запасного перехода на enterprise-группу, как у official-relay `gpt-image-2`.

| Модель            | Группа       | Примечания                                                                                                                                        |
| ----------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gpt-image-2-all` | `Default`    | ChatGPT-web, обратный канал, фикс. \$0.03/img, \~30–60 с                                                                                          |
| `gpt-image-2-all` | `image2_OSS` | **коэффициент тарифа 1x (без надбавки)**, детерминированный вывод URL — никогда не откатывается к base64, когда группа по умолчанию под нагрузкой |

### Нужен детерминированный вывод URL → переключитесь на группу `image2_OSS`

По измерениям в июле 2026 года в группе по умолчанию `gpt-image-2-all` (и `gpt-image-2-vip`) возвращают `b64_json`, когда `response_format` опущен; передайте `response_format: "url"` явно, чтобы получить URL изображения. Формат вывода группы по умолчанию **не гарантирован** — исторически он по умолчанию использовал `url` с откатом к `b64_json` при нагрузке и менялся между версиями канала.

Если ваш бизнес **зависит от вывода URL** (сохранение URL напрямую в вашу базу данных, frontend-рендеринг по URL, base64 не подходит), переключите группу вашего token на **`image2_OSS`** — группу, специально созданную для **детерминированного вывода URL**, с **коэффициентом тарифа 1x (без надбавки)**, которая действует для обеих reverse-моделей `gpt-image-2-all` и `gpt-image-2-vip`. Она гарантирует, что ответ всегда содержит URL изображения и никогда не откатывается к base64.

<Frame caption="Token creation: set billing mode to &#x22;pay-as-you-go first&#x22; and pick the image2_OSS group (1x) — use it when you need deterministic URL output">
  <img src="https://mintcdn.com/apiyillc/eNGQJU-a_dFb12gU/images/image2-oss-token-setup-20260525.png?fit=max&auto=format&n=eNGQJU-a_dFb12gU&q=85&s=727f61464cc759006a59e8de6ceccd32" alt="Экран создания token: сначала режим тарификации pay-as-you-go, группа image2_OSS (коэффициент тарифа 1x), группа, выводящая URL изображений, подходит для gpt-image-2-all и gpt-image-2-vip" width="1278" height="846" data-path="images/image2-oss-token-setup-20260525.png" />
</Frame>

<Tip>
  **Дополнительно (если вы также используете `gpt-image-2-vip` и official-relay `gpt-image-2`)**: если ваш token покрывает все три модели, задайте приоритет групп для token следующим образом:

  * **Первый приоритет**: `image2Enterprise` (enterprise-группа с коэффициентом тарифа 1.2x, выделенная стабильная полоса для официального релея)
  * **Запасной вариант по умолчанию**: `Default` (обе reverse-модели находятся здесь и маршрутизируются по модели)

  Результат: official-relay `gpt-image-2` идет по enterprise-полосе ради стабильности, а две reverse-модели остаются в группе по умолчанию — один token покрывает все три, без взаимного влияния.
</Tip>

📖 О группе `image2Enterprise`: [/en/live/2026-04/image2-enterprise-stable](/en/live/2026-04/image2-enterprise-stable)

## Технические характеристики

| Атрибут                        | Значение                                                                                                                   |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| **Название модели**            | `gpt-image-2-all`                                                                                                          |
| **Тип канала**                 | Официальный реверс-инжиниринг (веб-версия ChatGPT)                                                                         |
| **Тарификация**                | \$0.03 / image, per-call                                                                                                   |
| **Время генерации**            | \~30–60 секунд                                                                                                             |
| **Разрешение вывода**          | Явного параметра размера нет; адаптивно (опишите в prompt)                                                                 |
| **Формат ответа по умолчанию** | `b64_json` (сырой base64, **без префикса `data:`**, проверено в 2026-07; всегда явно передавайте `response_format`)        |
| **Дополнительный формат**      | `url` (ускоренная ссылка через R2 CDN, **срок действия \~1 день**, требуется явный `response_format: "url"`)               |
| **Китайские prompt**           | ✅ Нативная поддержка                                                                                                       |
| **Возможности**                | text-to-image, редактирование одного изображения, объединение нескольких изображений, редактирование на естественном языке |

<Warning>
  Эта модель имеет **адаптивные размеры вывода** и не эквивалентна официальному `gpt-image-2` API. Для строго зафиксированных размеров вывода или 4K используйте [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) (реверс-версия Codex, 30 явных размеров, включая 4K). Для полного соответствия официальному API используйте [`gpt-image-2`](/ru/api-capabilities/gpt-image-2/overview).
</Warning>

<Warning>
  **⏰ Срок действия URL изображения: \~1 день (по умолчанию)**

  Поле `url` ответа в режиме `url` — это ссылка R2 CDN, которая **истекает примерно через 24 часа** — после этого запросы будут возвращать 404. Для изображений, которые нужно хранить долгое время (товарные фото, пользовательские работы, архивные записи и т. д.), **скачайте и сохраните их в своем хранилище как можно скорее** после генерации.

  Два распространенных подхода:

  * **Скачивание на стороне сервера**: сразу после получения ответа используйте `requests` / `fetch`, чтобы загрузить изображение и сохранить его в S3 / OSS / R2 / на локальный диск
  * **Используйте формат ответа `b64_json`**: вы получаете изображение сразу в виде base64-данных, без дополнительной cross-origin-загрузки — идеально для рендеринга на фронтенде или прямой записи в файл
</Warning>

## Эндпоинты

| Эндпоинт                      | Назначение                                           | Content-Type          | Лучше всего для                                                                                               |
| ----------------------------- | ---------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------- |
| `POST /v1/images/generations` | Текст в изображение                                  | `application/json`    | Стандартный формат OpenAI Images API — один и тот же код может работать и с официальным, и с обратным каналом |
| `POST /v1/images/edits`       | Редактирование изображений (одиночное/множественное) | `multipart/form-data` | Стандартный формат OpenAI Images API — один и тот же код может работать и с официальным, и с обратным каналом |

<Tip>
  **Используйте OpenAI Images API** (`/v1/images/generations` + `/v1/images/edits`), по двум причинам:

  1. **Более стабильно**: upstream-ресурсов для канала Images API больше, поэтому вероятность успешного вызова выше
  2. **Совместимо с официальным релеем для удобного переключения**: способ вызова и такие параметры, как `size`, полностью совместимы с official-relay [`gpt-image-2`](/ru/api-capabilities/gpt-image-2/overview) — если на обратном канале возникают проблемы с риск-контролем, **просто замените имя `model`** без каких-либо изменений в коде

  Также есть эндпоинт на основе chat (`/v1/chat/completions`, больше не рекомендуется) — см. FAQ ниже.
</Tip>

<Tip>
  **Варианты домена**: `api.apiyi.com` — основной домен. Вы также можете использовать альтернативные домены шлюза, такие как `b.apiyi.com` / `vip.apiyi.com`. Поведение ответов одинаковое.
</Tip>

<Info>
  **Хотите зафиксировать размер вывода с помощью параметра `size`?** Используйте родственную модель [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) — те же эндпоинты, только одно дополнительное поле `size` (30 явных размеров, включая 4K).
</Info>

## Управление размером и соотношением сторон (описывайте в prompt)

`gpt-image-2-all` не имеет параметра `size` — размер задается в prompt. Если вам нужны строго фиксированные размеры вывода (hero-изображения для e-commerce, шаблоны постеров, обои 4K), используйте [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) вместо этого.

### Проверенная таблица «формулировка prompt → фактическое разрешение»

Восемь формулировок ниже эмпирически подтверждены и стабильно воспроизводятся. Поместите формулировку из первого столбца в **начало** prompt, и вы получите разрешение, указанное во втором столбце (все результаты находятся на уровне \~1.5K пикселей):

| Формулировка prompt (передавать дословно) | Проверенное разрешение | Примерный размер | Фактическое соотношение |
| ----------------------------------------- | ---------------------- | ---------------- | ----------------------- |
| `横版 16:9` (альбомная ориентация 16:9)     | 1672 × 941             | \~1.9 MB         | 16:9                    |
| `竖屏 9:16` (книжная ориентация 9:16)       | 941 × 1672             | \~2.1 MB         | 9:16                    |
| `4:3`                                     | 1448 × 1086            | \~2.3 MB         | 4:3                     |
| `3:4`                                     | 1086 × 1448            | \~2.5 MB         | 3:4                     |
| `3:2 尺寸` (размер 3:2)                     | 1536 × 1024            | \~2.9 MB         | 3:2                     |
| `2:3 尺寸` (размер 2:3)                     | 1024 × 1536            | \~3.0 MB         | 2:3                     |
| `2:5 竖屏` (книжная ориентация 2:5)         | 793 × 1983             | \~1.9 MB         | 2:5                     |
| `5:2 横屏` (альбомная ориентация 5:2)       | 1983 × 793             | \~1.9 MB         | 5:2                     |

<Info>
  **Примечания**:

  * Все результаты находятся на уровне **\~1.5K-пикселей** (длинная сторона от 1500 до 2000 px). Это фактический потолок модели — это не по-настоящему «любое разрешение».
  * Воспроизводимость максимальна, когда prompt **только** содержит формулировку из таблицы; добавление других слов про композицию вызывает дрейф.
  * Китайские строки — это фактические значения, которые вы отправляете; рекомендуем оставлять их как есть, а не переводить.
</Info>

### Стилевые формулировки (без фиксированного разрешения)

Формулировки ниже не имеют проверенного разрешения — используйте их только как модификаторы стиля, в сочетании с таблицей выше:

| Нужно                | Формулировка (только для указания стиля — без гарантии разрешения) |
| -------------------- | ------------------------------------------------------------------ |
| Квадрат              | `1024×1024 square` / `1:1 square composition`                      |
| Ультраширокий баннер | `Banner 21:9 ultra-widescreen`                                     |
| Модификатор стиля    | `cinematic` / `phone poster` / `square composition`                |

<Tip>
  **Совет**: Размещайте слова о размере/композиции в **начале** prompt для лучшего соблюдения.
</Tip>

### Как показывать эту таблицу вашим пользователям

Хотя у `gpt-image-2-all` нет `size` параметра, вы все равно можете предложить пользователям выпадающий список «Размер / Соотношение сторон», который выглядит почти как официальное поле `size`:

* Используйте формулировку prompt из таблицы выше как значение опции `value` (например, `横版 16:9`)
* Показывайте **ожидаемое разрешение** в подписи опции (например, `Landscape 16:9 (1672×941)`), чтобы пользователи знали, что получат
* На стороне backend добавляйте выбранную формулировку в начало исходного prompt пользователя перед отправкой в API

```js theme={null}
const SIZE_OPTIONS = [
  { label: "Landscape 16:9 (1672×941)", prefix: "横版 16:9" },
  { label: "Portrait 9:16 (941×1672)",  prefix: "竖屏 9:16" },
  { label: "4:3 (1448×1086)",           prefix: "4:3" },
  { label: "3:4 (1086×1448)",           prefix: "3:4" },
  { label: "3:2 (1536×1024)",           prefix: "3:2 尺寸" },
  { label: "2:3 (1024×1536)",           prefix: "2:3 尺寸" },
  { label: "2:5 portrait (793×1983)",   prefix: "2:5 竖屏" },
  { label: "5:2 landscape (1983×793)",  prefix: "5:2 横屏" },
];

const finalPrompt = `${selected.prefix}, ${userPrompt}`;
```

<Warning>
  Базовая модель по-прежнему **адаптивна** — небольшие отклонения на уровне пикселей это нормально. Не обещайте пользователям идеальный результат пиксель-в-пиксель. **Если нужны строго фиксированные размеры вывода** (hero-изображения для e-commerce, шаблоны постеров, обои 4K), используйте родственную модель [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) — та же цена, тот же код вызова, только одно дополнительное поле `size`.
</Warning>

## Лучшие практики

<Steps>
  <Step title="Сжимайте входные изображения до менее 1.5MB (редактирование изображений / слияние нескольких изображений)">
    Сжимайте каждое загружаемое вами изображение до **менее 1.5MB** (качество JPEG 80-90 / уменьшенное разрешение); применяйте тот же лимит к каждому изображению при слиянии нескольких изображений. Периодические ошибки на стороне сервера чаще всего вызываются слишком большими входными данными — сжатие заметно повышает вероятность успеха и снижает задержку. **Выходное разрешение определяется формулировкой prompt, а не размером входных данных** — уменьшение входного размера лишь ускоряет процесс, но не ухудшает качество. Попытка вставить в prompt `4K` / `8K` тоже не даст изображение высокого разрешения; для надежного получения более крупного результата используйте проверенные формулировки в таблице «Проверенная формулировка prompt → фактическое разрешение» выше.
  </Step>

  <Step title="Размещайте размер в начале prompt">
    Слова о соотношении сторон, разрешении и композиции в начале prompt обеспечивают лучшее соответствие.
  </Step>

  <Step title="Уверенно используйте текстовые элементы">
    Качество рендеринга текста — одно из ключевых преимуществ: вывески, постеры, инфографика с китайским/английским текстом работают хорошо.
  </Step>

  <Step title="Обозначайте порядок нескольких изображений">
    Порядок, в котором вы повторяете поле `image`, имеет значение. Явно указывайте его в prompt как «image1/image2/image3».
  </Step>

  <Step title="Выбирайте формат ответа по задаче">
    Используйте `b64_json` для прямого веб-рендеринга; `url` для серверного хранения/пересылки.
  </Step>

  <Step title="Используйте таймаут 300s">
    Типичная генерация занимает 30–60s, но время загрузки/скачивания изображения и пиковые хвосты обратного канала сильно влияют на общее сквозное время. **Установите 300s как консервативную базовую величину** , чтобы избежать частых ложных таймаутов.
  </Step>

  <Step title="Убирайте неподдерживаемые параметры">
    `gpt-image-2-all` не принимает `size`, `n`, `quality`, `aspect_ratio` — их отправка может вызвать ошибки валидации. Чтобы пройти `size`, переключитесь на [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview).
  </Step>
</Steps>

## Коды ошибок и повторные попытки

| Статус  | Значение                                                                              | Рекомендация                                          |
| ------- | ------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| `401`   | Недействительный token                                                                | Проверьте Bearer Token                                |
| `429`   | Лимит запросов / квота исчерпаны                                                      | Повторная попытка с экспоненциальной задержкой        |
| `5xx`   | Временная ошибка шлюза/backend                                                        | Повторите 1–2 раза                                    |
| Timeout | Пиковая нагрузка обратного канала + длинный хвост при загрузке/скачивании изображений | Установите таймаут клиента **≥ 300s** (консервативно) |

<Info>
  **Рекомендации для клиента**:

  * Таймаут запроса — начиная с 300 секунд (консервативно; обычно 30–60s, но загрузка / скачивание изображений и пиковые хвосты обратного канала создают большую вариативность — 120s вызывает частые ложные таймауты)
  * Используйте **экспоненциальную задержку** для 5xx и таймаутов (рекомендуется 2–3 повторные попытки)
  * Логируйте заголовок ответа `request-id` для отладки
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="Вижу и gpt-image-2-all, и gpt-image-2-vip — что выбрать?">
    Оба — реверс-инженерные каналы с одной и той же ценой (\$0.03/вызов) и **идентичным форматом вызова**. Различия — в поддержке `size` и времени генерации:

    * **Не нужна строгая фиксация размера, нужен более быстрый результат** → `gpt-image-2-all` (\~30–60 с, укажите размер в prompt).
    * **Нужен закреплённый размер вывода или 4K** → [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) (\~90–150 с, 30 фиксированных размеров, включая 4K).
    * **Нужна настройка `quality` или полное соответствие полям OpenAI-API** → используйте официальный [`gpt-image-2`](/ru/api-capabilities/gpt-image-2/overview).
  </Accordion>

  <Accordion title="Можно ли генерировать несколько изображений за один раз?">
    Нет. Эта модель возвращает 1 изображение за вызов. Для N изображений вызывайте API N раз параллельно. Каждый вызов тарифицируется отдельно по \$0.03.
  </Accordion>

  <Accordion title="Поддерживает ли она параметр n? Что будет, если я передам n=3?">
    **Нет.** Эта модель возвращает 1 изображение за вызов — для нескольких изображений используйте **повторные / параллельные вызовы**.

    ⚠️ **Важно**: если вы передадите `n=3` в запросе, **тарификация составит 0.03 × 3 = \$0.09**, но **фактически будет возвращено только 1 изображение**. Обязательно удалите поле `n` из запросов, чтобы избежать лишних списаний.
  </Accordion>

  <Accordion title="Если контент отклонён или модель отвечает «Я не могу этого сделать», тарифицируется ли это?">
    Это реверс-инженерный канал, использующий **синхронные ответы в стиле chat**. Результаты делятся на два случая с **разными правилами тарификации**:

    **1) Возвращён HTTP 5xx → НЕ тарифицируется**

    Когда upstream жёстко блокирует запрос по политике контента, вы увидите примерно такое:

    ```json theme={null}
    {
      "error": {
        "message": "Image was not generated as expected. Please adjust the prompt and retry (traceid: 0672821c6951af183dbf847130caaf16)",
        "localized_message": "Unknown error",
        "type": "invalid_request_error",
        "param": "",
        "code": null
      }
    }
    ```

    Эти жёсткие ошибки **не тарифицируются**. Попросите пользователя скорректировать prompt и повторить попытку.

    **2) HTTP 200 с текстовым «мягким отказом» → ТАРИФИЦИРУЕТСЯ**

    Когда модель мягко отказывает внутри диалога (например, «Я не могу этого сделать», «Извините, этот запрос затрагивает…»), на уровне протокола это выглядит как обычный chat completion, поэтому **это тарифицируется**. Реверс-канал не может надёжно отличить «текст отказа» от «вывода изображения» на уровне протокола.

    **Почему мы не можем просто отменять мягкие отказы**

    Автоматическая отмена каждого мягкого отказа означала бы, что платформа берёт на себя каждый неудачный upstream-вызов. Что ещё важнее, **частое срабатывание upstream-защиты контента также повышает риск блокировки аккаунта у поставщика** — это реальная издержка со стороны поставки, которую мы не можем полностью устранить.

    **Рекомендации для интеграторов**

    * ✅ **Предварительно фильтруйте и предупреждайте пользователей**: добавьте фильтр по ключевым словам/сценариям на фронтенде или шлюзе (имена реальных людей, защищённые авторским правом персонажи, чувствительные темы) и выводите подсказку в интерфейсе вроде «Темы со знаменитостями / IP могут не пройти и всё равно быть тарифицированы по политике upstream». Это резко сокращает лишние списания.
    * ✅ **Ежемесячная компенсация для consumer-продуктов**: мы понимаем, что consumer-facing продуктам невозможно полностью ограничить пользовательский ввод. Если ваши ежемесячные расходы достаточно велики (**\$1000+/месяц**), вы можете **ежемесячно пакетировать логи** (запросы с низкой задержкой обычно являются мягкими отказами) и обратиться в поддержку за разовой ручной компенсацией — не нужно подавать обращение по каждому вызову.

    📖 Связано: [Ошибки 500 обычно связаны с политикой контента (не тарифицируются)](/en/live/2026-04/gpt-image-2-all-500-content-policy)
  </Accordion>

  <Accordion title="Нужно ли добавлять префикс data:image/png;base64, к b64_json?">
    **Сначала определяйте, потом обрабатывайте.** Как подтверждено в июле 2026 года, возвращаемое `b64_json` — это **raw base64 без префикса `data:`**: декодируйте его, чтобы записать файл, или добавьте префикс сами перед рендерингом; **в более ранних версиях префикс действительно был**. Добавьте в код проверку `startsWith('data:')`: если префикс присутствует, используйте значение напрямую как `img src`; если нет, сначала декодируйте или добавьте префикс — это поможет избежать двойного добавления префикса или декодирования строка с префиксом в битое изображение.
  </Accordion>

  <Accordion title="Почему я получаю другой размер, хотя в prompt указано 1024x1024?">
    Адаптивные модели воспринимают указания размера как «ориентир», а не как «жёсткое требование». Чтобы повысить соблюдение: ставьте слова о размере/композиции в самое начало prompt и сочетайте их с описателями стиля (например, `cinematic`, `phone poster`, `square composition`).

    Для формулировок, которые **надёжно** соответствуют конкретному разрешению, см. таблицу «Проверенная формулировка prompt → фактическое разрешение» ранее на этой странице (в разделе «Управление размером и соотношением сторон»).
  </Accordion>

  <Accordion title="Нужно ли сжимать входные изображения? Помогает ли написание 4K / 8K в prompt?">
    **Да, настоятельно рекомендуется.** Сжимайте каждое входное изображение до **менее 1.5MB** (JPEG quality 80-90 / уменьшенное разрешение): спорадические ошибки на стороне сервера чаще всего вызываются слишком большими входными данными, а сжатие заметно повышает успешность и снижает задержку. Примечание: 1.5MB — это **рекомендуемый верхний предел** для надёжности и скорости; число 10MB в FAQ выше — это жёсткий лимит шлюза.

    **Не переживайте, что сжатие ухудшит качество** — выходное разрешение этой модели определяется формулировкой композиции в prompt, а не размером входа. Уменьшение входа только ускоряет обработку.

    **Добавление `4K` / `8K` в prompt на самом деле не создаёт изображение высокого разрешения** — это декоративные слова, и модель не повышает разрешение из-за них. Для надёжно большего вывода используйте проверенные формулировки из таблицы «Проверенная формулировка prompt → фактическое разрешение» выше (например, `cinematic`, `phone poster`, `square composition`). Для строгой фиксации размера или 4K переключитесь на [`gpt-image-2-vip`](/ru/api-capabilities/gpt-image-2-vip/overview) (30 фиксированных размеров, включая 4K, по фиксированной цене \$0.03/изображение).
  </Accordion>

  <Accordion title="Каков максимальный размер референсного изображения и поддерживаемые форматы?">
    Рекомендуется **≤ 10MB на изображение**, форматы `png` / `jpg` / `webp`. Слишком большие изображения могут упереться в лимиты шлюза. Каждое изображение при слиянии нескольких изображений должно соответствовать этому лимиту.
  </Accordion>

  <Accordion title="Как долго действуют возвращаемые URL изображений? Нужно ли их скачивать?">
    Поле `url` ответа в режиме `url` — это **ссылка R2 CDN, которая истекает примерно через 1 день (24 часа)**: после этого запросы будут возвращать 404.

    **Настоятельно рекомендуется**: сразу после генерации скачивайте и сохраняйте изображения в ваше **собственное object storage (S3 / OSS / R2), CDN или базу данных**. Не используйте возвращённый URL как постоянную прямую ссылку.

    **Два рекомендуемых подхода**:

    * **Прокси на стороне сервера**: сразу `requests.get(url)` после ответа, сохраняйте в своё хранилище и возвращайте на фронтенд собственный URL;
    * **Используйте `b64_json`**: добавьте `"response_format": "b64_json"` в запрос, чтобы получить base64-данные изображения напрямую — на одну кросс-доменную загрузку меньше, идеально для рендеринга на фронтенде или записи сразу в файл.

    Для краткоживущих предпросмотров (отображение в рамках одной сессии) R2 URL работает как есть без сохранения.
  </Accordion>

  <Accordion title="Поддерживает ли она потоковую передачу?">
    Нет. Эта модель возвращает изображение за один раз; потоковая передача не поддерживается. Если важна задержка, показывайте на клиенте индикатор прогресса «генерация...» и настройте **таймаут 300 с** (с запасом).
  </Accordion>

  <Accordion title="Можно ли использовать официальный OpenAI SDK?">
    Да. Укажите `base_url` на `https://api.apiyi.com/v1` и задайте `api_key` как ваш APIYI token. Однако `client.images.generate()` по умолчанию отправляет `size`/`n` — эта модель отклоняет оба параметра, поэтому мы рекомендуем делать прямые HTTP-запросы с `requests` / `fetch` к `/v1/images/generations` и `/v1/images/edits`.
  </Accordion>

  <Accordion title="Есть ли заметная разница между prompt на китайском и английском?">
    Эта модель изначально поддерживает китайский, и результаты сопоставимы. Для сценариев, специфичных для китайского языка (каллиграфия, элементы традиционных праздников), формулировки на китайском звучат естественнее.
  </Accordion>

  <Accordion title="Можно ли по-прежнему генерировать изображения через /v1/chat/completions?">
    Да, endpoint по-прежнему работает, но **больше не рекомендуется** — вместо этого используйте `/v1/images/generations` и `/v1/images/edits` (так стабильнее, и тот же код работает с `gpt-image-2` официального релея).

    Формат на основе chat имеет смысл только в двух сценариях: многоходовое итеративное редактирование или передача онлайн-URL изображений напрямую. Учтите, что если намерение изображения неоднозначно, модель может вернуть обычный текст вместо изображения (добавьте к prompt фиксированный префикс вроде «Сгенерируйте изображение:», чтобы усилить намерение).

    Полный список параметров см. в [справке по API на основе chat](/en/api-capabilities/gpt-image-2-all/chat-completions).
  </Accordion>
</AccordionGroup>

## Связанная документация

* [⚖️ Сравнение официальной и реверс-версии](/ru/api-capabilities/gpt-image-2/vs-gpt-image-2-all) - Руководство по выбору рядом с официальным `gpt-image-2`
* [Песочница Text-to-Image](/ru/api-capabilities/gpt-image-2-all/text-to-image) - Совместимый эндпоинт `/v1/images/generations`
* [Песочница редактирования изображений](/ru/api-capabilities/gpt-image-2-all/image-edit) - Многоизображенийное объединение и редактирование `/v1/images/edits`
* [GPT-Image-2-VIP (та же цена, поддерживает `size` и 4K)](/ru/api-capabilities/gpt-image-2-vip/overview) - Сестринская модель с той же ценой и 30 явными размерами (включая 4K); идентичный формат вызова
* [GPT-Image-2 Official (оплата по token)](/ru/api-capabilities/gpt-image-2/overview) - Для параметра `quality` / перерисовки на основе маски / строгого соответствия полям OpenAI-API
* [Обзор серии GPT-Image](/en/api-capabilities/gpt-image-series) - Официальное сравнение GPT-Image
* [Сообщество: узлы Luck GPT-Image 2 ComfyUI](/ru/scenarios/ecosystem/luckgpt2-comfyui) - Вызывайте `gpt-image-2-all` напрямую в ComfyUI (два эндпоинта: chat\_completions / images\_api)
* [Сообщество: навыки APIYI GPT-Image 2](/ru/scenarios/ecosystem/apiyi-gpt-image-skills) - Вызывайте из Codex CLI / Cursor / Gemini CLI и других AI-инструментов для кодирования одной строкой
* [Руководство по API](/ru/api-manual) - Общие правила вызова

<Info>
  gpt-image-2-all is a канал, созданный на основе реверс-инжиниринга. Поведение согласовано, но тарификация/возможности могут не полностью совпадать с официальной версией. Для официальной прямой версии см. [GPT-Image-1.5](/en/api-capabilities/gpt-image-1-5).
</Info>
