Skip to main content
Все API генерации изображений являются синхронными — здесь нет task ID для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно тарифицируется. Установите для этой модели увеличенный timeout; см. Основы и лучшие практики Image API.

Обзор

gpt-image-2-all — это обратно-инженеренная модель генерации изображений GPT (линейка веб-версии ChatGPT), доступная на платформе APIYI. При чрезвычайно конкурентной цене $0.03/image за запрос она генерирует изображения примерно за 30–60 секунд и поддерживает text-to-image / редактирование одного изображения / слияние нескольких изображений / редактирование на естественном языке — с высокой точностью рендеринга текста и нативной поддержкой китайских prompt.
🎨 Основные моменты: Надежный обратн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 — тот же формат вызова, только одно дополнительное поле size.

API генерации изображений по тексту

/v1/images/generations — генерируйте изображения по текстовым prompt.

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

/v1/images/edits — многочастичная загрузка с инструкциями по редактированию/слиянию.

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

Очень выгодные цены

Фиксированная цена за каждый вызов: $0.03/image, без уровней по разрешению, с предсказуемыми затратами

Качественный рендеринг текста

Стабильный рендеринг китайского/английского текста, вывесок и текста на постерах — идеально для инфографики и маркетинговых материалов

Поддержка prompt на китайском

Нативное понимание описаний на китайском без перевода

Слияние нескольких изображений

Поддерживает несколько референсных изображений; prompt могут ссылаться на них как “image1/image2/image3”

Быстрый результат

~30–60 с на генерацию — быстрее, чем и gpt-image-2-vip, и официальный релей gpt-image-2

Ускорение через R2 CDN

Передавайте response_format: "url" явно для ссылок R2 CDN с глобальной доставкой с низкой задержкой

Редактирование на естественном языке

Редактируйте с помощью описаний в формате диалога, маски не требуются, поддерживается многоходовая итерация

Поддержка стандартных эндпоинтов

Совместимо со стандартными эндпоинтами OpenAI Images API /images/generations и /images/edits

Тарифы

Примечания по тарификации:
  • Фиксированная цена; без уровней по разрешению, качеству или длине prompt
  • Неудачные запросы не тарифицируются (ошибки аутентификации, ошибки проверки параметров)
  • Для N изображений вызывайте API N раз параллельно
Сестринская модель с той же ценой: gpt-image-2-vip (обратная линия Codex) — та же цена $0.03/изображение, поддерживает 30 явных размеров (включая 4K), тот же формат вызова. Переключайтесь, когда вам нужны фиксированные размеры вывода.

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

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

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

По измерениям в июле 2026 года в группе по умолчанию gpt-image-2-allgpt-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.
Экран создания token: сначала режим тарификации pay-as-you-go, группа image2_OSS (коэффициент тарифа 1x), группа, выводящая URL изображений, подходит для gpt-image-2-all и gpt-image-2-vip

Token creation: set billing mode to "pay-as-you-go first" and pick the image2_OSS group (1x) — use it when you need deterministic URL output

Дополнительно (если вы также используете 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 покрывает все три, без взаимного влияния.
📖 О группе image2Enterprise: /en/live/2026-04/image2-enterprise-stable

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

Эта модель имеет адаптивные размеры вывода и не эквивалентна официальному gpt-image-2 API. Для строго зафиксированных размеров вывода или 4K используйте gpt-image-2-vip (реверс-версия Codex, 30 явных размеров, включая 4K). Для полного соответствия официальному API используйте gpt-image-2.
⏰ Срок действия URL изображения: ~1 день (по умолчанию)Поле url ответа в режиме url — это ссылка R2 CDN, которая истекает примерно через 24 часа — после этого запросы будут возвращать 404. Для изображений, которые нужно хранить долгое время (товарные фото, пользовательские работы, архивные записи и т. д.), скачайте и сохраните их в своем хранилище как можно скорее после генерации.Два распространенных подхода:
  • Скачивание на стороне сервера: сразу после получения ответа используйте requests / fetch, чтобы загрузить изображение и сохранить его в S3 / OSS / R2 / на локальный диск
  • Используйте формат ответа b64_json: вы получаете изображение сразу в виде base64-данных, без дополнительной cross-origin-загрузки — идеально для рендеринга на фронтенде или прямой записи в файл

Эндпоинты

Используйте OpenAI Images API (/v1/images/generations + /v1/images/edits), по двум причинам:
  1. Более стабильно: upstream-ресурсов для канала Images API больше, поэтому вероятность успешного вызова выше
  2. Совместимо с официальным релеем для удобного переключения: способ вызова и такие параметры, как size, полностью совместимы с official-relay gpt-image-2 — если на обратном канале возникают проблемы с риск-контролем, просто замените имя model без каких-либо изменений в коде
Также есть эндпоинт на основе chat (/v1/chat/completions, больше не рекомендуется) — см. FAQ ниже.
Варианты домена: api.apiyi.com — основной домен. Вы также можете использовать альтернативные домены шлюза, такие как b.apiyi.com / vip.apiyi.com. Поведение ответов одинаковое.
Хотите зафиксировать размер вывода с помощью параметра size? Используйте родственную модель gpt-image-2-vip — те же эндпоинты, только одно дополнительное поле size (30 явных размеров, включая 4K).

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

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

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

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

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

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

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

Хотя у gpt-image-2-all нет size параметра, вы все равно можете предложить пользователям выпадающий список «Размер / Соотношение сторон», который выглядит почти как официальное поле size:
  • Используйте формулировку prompt из таблицы выше как значение опции value (например, 横版 16:9)
  • Показывайте ожидаемое разрешение в подписи опции (например, Landscape 16:9 (1672×941)), чтобы пользователи знали, что получат
  • На стороне backend добавляйте выбранную формулировку в начало исходного prompt пользователя перед отправкой в API
Базовая модель по-прежнему адаптивна — небольшие отклонения на уровне пикселей это нормально. Не обещайте пользователям идеальный результат пиксель-в-пиксель. Если нужны строго фиксированные размеры вывода (hero-изображения для e-commerce, шаблоны постеров, обои 4K), используйте родственную модель gpt-image-2-vip — та же цена, тот же код вызова, только одно дополнительное поле size.

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

1

Сжимайте входные изображения до менее 1.5MB (редактирование изображений / слияние нескольких изображений)

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

Размещайте размер в начале prompt

Слова о соотношении сторон, разрешении и композиции в начале prompt обеспечивают лучшее соответствие.
3

Уверенно используйте текстовые элементы

Качество рендеринга текста — одно из ключевых преимуществ: вывески, постеры, инфографика с китайским/английским текстом работают хорошо.
4

Обозначайте порядок нескольких изображений

Порядок, в котором вы повторяете поле image, имеет значение. Явно указывайте его в prompt как «image1/image2/image3».
5

Выбирайте формат ответа по задаче

Используйте b64_json для прямого веб-рендеринга; url для серверного хранения/пересылки.
6

Используйте таймаут 300s

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

Убирайте неподдерживаемые параметры

gpt-image-2-all не принимает size, n, quality, aspect_ratio — их отправка может вызвать ошибки валидации. Чтобы пройти size, переключитесь на gpt-image-2-vip.

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

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

FAQ

Оба — реверс-инженерные каналы с одной и той же ценой ($0.03/вызов) и идентичным форматом вызова. Различия — в поддержке size и времени генерации:
  • Не нужна строгая фиксация размера, нужен более быстрый результатgpt-image-2-all (~30–60 с, укажите размер в prompt).
  • Нужен закреплённый размер вывода или 4Kgpt-image-2-vip (~90–150 с, 30 фиксированных размеров, включая 4K).
  • Нужна настройка quality или полное соответствие полям OpenAI-API → используйте официальный gpt-image-2.
Нет. Эта модель возвращает 1 изображение за вызов. Для N изображений вызывайте API N раз параллельно. Каждый вызов тарифицируется отдельно по $0.03.
Нет. Эта модель возвращает 1 изображение за вызов — для нескольких изображений используйте повторные / параллельные вызовы.⚠️ Важно: если вы передадите n=3 в запросе, тарификация составит 0.03 × 3 = $0.09, но фактически будет возвращено только 1 изображение. Обязательно удалите поле n из запросов, чтобы избежать лишних списаний.
Это реверс-инженерный канал, использующий синхронные ответы в стиле chat. Результаты делятся на два случая с разными правилами тарификации:1) Возвращён HTTP 5xx → НЕ тарифицируетсяКогда upstream жёстко блокирует запрос по политике контента, вы увидите примерно такое:
Эти жёсткие ошибки не тарифицируются. Попросите пользователя скорректировать prompt и повторить попытку.2) HTTP 200 с текстовым «мягким отказом» → ТАРИФИЦИРУЕТСЯКогда модель мягко отказывает внутри диалога (например, «Я не могу этого сделать», «Извините, этот запрос затрагивает…»), на уровне протокола это выглядит как обычный chat completion, поэтому это тарифицируется. Реверс-канал не может надёжно отличить «текст отказа» от «вывода изображения» на уровне протокола.Почему мы не можем просто отменять мягкие отказыАвтоматическая отмена каждого мягкого отказа означала бы, что платформа берёт на себя каждый неудачный upstream-вызов. Что ещё важнее, частое срабатывание upstream-защиты контента также повышает риск блокировки аккаунта у поставщика — это реальная издержка со стороны поставки, которую мы не можем полностью устранить.Рекомендации для интеграторов
  • Предварительно фильтруйте и предупреждайте пользователей: добавьте фильтр по ключевым словам/сценариям на фронтенде или шлюзе (имена реальных людей, защищённые авторским правом персонажи, чувствительные темы) и выводите подсказку в интерфейсе вроде «Темы со знаменитостями / IP могут не пройти и всё равно быть тарифицированы по политике upstream». Это резко сокращает лишние списания.
  • Ежемесячная компенсация для consumer-продуктов: мы понимаем, что consumer-facing продуктам невозможно полностью ограничить пользовательский ввод. Если ваши ежемесячные расходы достаточно велики ($1000+/месяц), вы можете ежемесячно пакетировать логи (запросы с низкой задержкой обычно являются мягкими отказами) и обратиться в поддержку за разовой ручной компенсацией — не нужно подавать обращение по каждому вызову.
📖 Связано: Ошибки 500 обычно связаны с политикой контента (не тарифицируются)
Сначала определяйте, потом обрабатывайте. Как подтверждено в июле 2026 года, возвращаемое b64_json — это raw base64 без префикса data:: декодируйте его, чтобы записать файл, или добавьте префикс сами перед рендерингом; в более ранних версиях префикс действительно был. Добавьте в код проверку startsWith('data:'): если префикс присутствует, используйте значение напрямую как img src; если нет, сначала декодируйте или добавьте префикс — это поможет избежать двойного добавления префикса или декодирования строка с префиксом в битое изображение.
Адаптивные модели воспринимают указания размера как «ориентир», а не как «жёсткое требование». Чтобы повысить соблюдение: ставьте слова о размере/композиции в самое начало prompt и сочетайте их с описателями стиля (например, cinematic, phone poster, square composition).Для формулировок, которые надёжно соответствуют конкретному разрешению, см. таблицу «Проверенная формулировка 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 (30 фиксированных размеров, включая 4K, по фиксированной цене $0.03/изображение).
Рекомендуется ≤ 10MB на изображение, форматы png / jpg / webp. Слишком большие изображения могут упереться в лимиты шлюза. Каждое изображение при слиянии нескольких изображений должно соответствовать этому лимиту.
Поле 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 работает как есть без сохранения.
Нет. Эта модель возвращает изображение за один раз; потоковая передача не поддерживается. Если важна задержка, показывайте на клиенте индикатор прогресса «генерация…» и настройте таймаут 300 с (с запасом).
Да. Укажите 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.
Эта модель изначально поддерживает китайский, и результаты сопоставимы. Для сценариев, специфичных для китайского языка (каллиграфия, элементы традиционных праздников), формулировки на китайском звучат естественнее.
Да, endpoint по-прежнему работает, но больше не рекомендуется — вместо этого используйте /v1/images/generations и /v1/images/edits (так стабильнее, и тот же код работает с gpt-image-2 официального релея).Формат на основе chat имеет смысл только в двух сценариях: многоходовое итеративное редактирование или передача онлайн-URL изображений напрямую. Учтите, что если намерение изображения неоднозначно, модель может вернуть обычный текст вместо изображения (добавьте к prompt фиксированный префикс вроде «Сгенерируйте изображение:», чтобы усилить намерение).Полный список параметров см. в справке по API на основе chat.

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

gpt-image-2-all is a канал, созданный на основе реверс-инжиниринга. Поведение согласовано, но тарификация/возможности могут не полностью совпадать с официальной версией. Для официальной прямой версии см. GPT-Image-1.5.