Генерация изображений GPT-Image-2.5-All

GPT-Image-2.5-All: генерация/редактирование изображений

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

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

Обзор

gpt-image-2.5-all и gpt-image-2-all — это реверс-инжиниринговые модели генерации изображений GPT от APIYI (веб-линейка ChatGPT). Веб-приложение ChatGPT полностью перешло на Images 2.5, поэтому gpt-image-2-all уже создает изображения версии 2.5; новое название gpt-image-2.5-all лишь делает это обновление явным — оба названия имеют одинаковую цену и поведение и взаимозаменяемы; для новых проектов следует использовать gpt-image-2.5-all. Благодаря исключительно выгодной цене $0.025 за изображение за вызов (снижена с $0.03 от 2026-10-10), модель генерирует изображения примерно за 30–60 секунд и поддерживает генерацию изображений по тексту / редактирование одного изображения / объединение нескольких изображений / редактирование на естественном языке — с высокой точностью рендеринга текста и нативной поддержкой prompt на китайском языке.

🎨 Главное: Надежный реверс-инжиниринговый канал с фиксированной ценой $0.025 за изображение. Не нужно беспокоиться о параметрах size/quality/n — просто укажите размер и стиль в prompt. Использует стандартные эндпоинты OpenAI Images API: /v1/images/generations (генерация изображений по тексту) и /v1/images/edits (редактирование изображений).Нужно зафиксировать выходной размер или получить 4K? Переключитесь на родственную модель gpt-image-2-vip — тот же формат вызова, только с дополнительным полем size.

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

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

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

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

Поручите интеграцию ИИ-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

Сначала он запросит текстовую версию этой страницы (добавьте .md к любому docs URL), а затем напишет код под стек вашего проекта — таймаут, рендеринг base64, сжатие перед загрузкой и параметры, которые отклоняются этой моделью, уже заложены в требования.

Интегрируйте / выполните отладку генерации изображений по тексту (text-to-image) и редактирования изображений с помощью gpt-image-2-all в этом проекте.

Прочитайте документацию перед тем, как писать код: запросите https://docs.apiyi.com/en/api-capabilities/gpt-image-2-all/overview.md для получения текстовой версии этой страницы. Для более подробной информации о параметрах добавьте .md к …

Таймаут: увеличьте клиентский таймаут до 360 секунд. API изображений являются синхронными — task ID отсутствует, поэтому при отключении клиента результат будет потерян …

Всего 6 требований. Используйте кнопку ниже, чтобы скопировать prompt целиком.

От каких проблем защищает этот prompt

Требование	Предотвращаемая проблема
Таймаут увеличен до 360 с	В большинстве стандартных HTTP-клиентов таймаут по умолчанию составляет 30–60 с, из-за чего они обрывают запрос, пока сервер продолжает штатную генерацию, — при этом за отключенный запрос все равно начисляется тарификация. См. Основные сведения и рекомендации по работе с Image API
Явная отправка `response_format`	Значение по умолчанию ранее менялось; без явного указания вам придется обрабатывать структуры как `url`, так и `b64_json`
Никогда не отправлять `n`	Отправка значения 3 тарифицируется за 3 изображения, но возвращает только 1
Никогда не отправлять `size` / `quality`	Эта модель отклоняет оба параметра; размеры задаются с помощью префикса в prompt
Сжатие перед загрузкой	Фотографии со смартфонов обычно весят 4–5 МБ, а кодирование в base64 дополнительно увеличивает их объем примерно на 33%. См. Сжатие изображений и разрешение на выходе

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

Высококонкурентная цена

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

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

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

Поддержка 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

Тарифы

Модель	Тарификация	Цена	Результат
`gpt-image-2-all`	За вызов	$0.025 / изображение	1 изображение за вызов
`gpt-image-2.5-all`	За вызов	$0.025 / изображение (как у -all)	1 изображение за вызов, на базе GPT-Image 2.5

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

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

Цены на модели согласованы с официальными и могут меняться при их корректировке провайдером; приведенная выше таблица носит справочный характер — актуальные данные представлены на вкладке Цены на модели в верхней панели навигации: Цены на модели.

Снижение цены с 2026-10-10: $0.03 → $0.025/изображение (применяется как к gpt-image-2-all, так и к gpt-image-2.5-all).

Причина: серия -all сама по себе обеспечивает высокое качество изображений и работает стабильнее серии -vip — серия -vip сильнее подвержена контролю рисков на стороне провайдера (мы продолжаем поддерживать её и наращивать мощности, и -vip остаётся доступной). Снижение призвано сделать -all простым выбором по умолчанию для повседневной генерации изображений.
Единственный компромисс: разрешение на выходе составляет 1K–1.5K; 2K / 4K недоступны. Этого достаточно для повседневной генерации; выбирайте -vip или официальный релей, когда вам требуются фиксированные размеры или 4K.
На практике ещё дешевле: $0.025 — это цена до скидок; объедините её с бонусом за пополнение (10%–20% дополнительных средств), и фактическая стоимость станет ещё ниже.

Аналогичная модель: gpt-image-2-vip (Adobe reverse line (Firefly)) — $0.03/изображение, поддерживает 30 фиксированных размеров (включая 4K), тот же формат вызова. Переключайтесь на неё, когда вам нужны точные размеры на выходе или 4K.

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

gpt-image-2-all находится в группе Default — дополнительная группа не требуется. Обратный канал в настоящее время стабилен, поэтому сценарий переключения на корпоративную группу, как у официального релея gpt-image-2, здесь отсутствует.

Модель	Группа	Примечания
`gpt-image-2-all`	`Default`	Обратный канал ChatGPT-web, фиксированно $0.025/избр., ~30–60 с
`gpt-image-2.5-all`	`Default`	Версия GPT-Image 2.5 той же линейки, фиксированно $0.025/избр., те же группы, что и у -all
`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 в базу данных, рендеринг на фронтенде по URL, base64 не подходит), переключите группу вашего token на image2_OSS — группу, специально созданную для детерминированного вывода URL, с коэффициентом тарифа 1x (без наценки), действующую для обеих реверс-моделей gpt-image-2-all и gpt-image-2-vip. Она гарантирует, что ответ всегда содержит URL изображения и никогда не переключается на base64.

Экран создания token: сначала режим тарификации по факту использования, группа 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 и официальный релей gpt-image-2): если ваш token охватывает все три модели, настройте приоритет групп для token следующим образом:

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

Результат: официальный релей gpt-image-2 использует корпоративную линию для стабильности, а обе реверс-модели остаются в группе по умолчанию — один token покрывает все три модели без взаимных помех.

📖 О группе image2Enterprise: /en/live/2026-04/image2-enterprise-stable

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

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

Эта модель имеет адаптивные размеры на выходе и не эквивалентна официальному API gpt-image-2. Для строго фиксированных размеров вывода или разрешения 4K используйте gpt-image-2-vip (линейка реверс-инжиниринга Adobe (Firefly), 30 явных размеров, включая 4K). Для полной совместимости с официальным API используйте gpt-image-2.

⏰ Срок действия URL изображения: ~1 день (по умолчанию)Поле url ответа в режиме url представляет собой ссылку R2 CDN, срок действия которой истекает примерно через 24 часа — последующие запросы вернут ошибку 404. Если изображения требуют длительного хранения (карточки товаров, пользовательские работы, история и т. д.), скачайте и сохраните их в собственное хранилище как можно скорее после генерации.Два распространенных подхода:

Загрузка на стороне сервера: как только вы получите ответ, используйте requests / fetch, чтобы скачать изображение и сохранить его в S3 / OSS / R2 / на локальный диск
Использование формата ответа b64_json: вы получаете изображение напрямую в виде данных base64, минуя дополнительное кросс-доменное скачивание — идеально подходит для отрисовки на фронтенде или прямой записи в файл

Эндпоинты

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

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

Более высокая стабильность: вышестоящие ресурсы для канала Images API более доступны, поэтому процент успешных вызовов выше
Совместимость с официальным релеем для удобного переключения: метод вызова и такие параметры, как size, полностью совместимы с официальным релеем gpt-image-2 — если reverse-канал сталкивается со сложностями систем риск-контроля, просто замените название model без изменений в коде

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

Варианты доменов: api.apiyi.com — основной домен. Вы также можете использовать альтернативные домены шлюза, такие как b.apiyi.com. Поведение ответов полностью идентично.

Хотите зафиксировать размер вывода с помощью параметра size? Используйте родственную модель gpt-image-2-vip — идентичные эндпоинты, лишь одно дополнительное поле size (30 фиксированных размеров, включая 4K).

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

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

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

8 приведенных ниже формулировок были проверены на практике и воспроизводятся стабильно. Добавьте формулировку из первой колонки в начало вашего prompt, и вы получите разрешение, указанное во второй колонке (все результаты находятся на уровне разрешения ~1,5K пикселей):

Формулировка в prompt (передается без изменений)	Проверенное разрешение	Приблиз. размер	Фактическое соотношение
`横版 16:9` (горизонтальный 16:9)	1672 × 941	~1,9 МБ	16:9
`竖屏 9:16` (вертикальный 9:16)	941 × 1672	~2,1 МБ	9:16
`4:3`	1448 × 1086	~2,3 МБ	4:3
`3:4`	1086 × 1448	~2,5 МБ	3:4
`3:2 尺寸` (размер 3:2)	1536 × 1024	~2,9 МБ	3:2
`2:3 尺寸` (размер 2:3)	1024 × 1536	~3,0 МБ	2:3
`2:5 竖屏` (вертикальный 2:5)	793 × 1983	~1,9 МБ	2:5
`5:2 横屏` (горизонтальный 5:2)	1983 × 793	~1,9 МБ	5:2

Примечания:

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

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

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

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

Совет: Помещайте слова, задающие размер или композицию, в начало prompt для более точного соблюдения.

Предоставление этой таблицы конечным пользователям

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

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

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}`;

Базовая модель по-прежнему остается адаптивной — небольшие отклонения на уровне пикселей являются нормальными. Не обещайте конечным пользователям вывод с точностью до пикселя (pixel-perfect). Для строго фиксированных размеров на выходе (главные баннеры для e-commerce, шаблоны плакатов, обои 4K) используйте родственную модель gpt-image-2-vip — та же цена, тот же код вызова, лишь одно дополнительное поле size.

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

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

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

Указывайте размер в начале prompt

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

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

Точность рендеринга текста — одно из ключевых преимуществ: вывески, плакаты и инфографика с текстом на китайском или английском языках получаются отлично.

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

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

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

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

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

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

Удаляйте отклоняемые параметры

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

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

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

Рекомендации для клиента:

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

Часто задаваемые вопросы (FAQ)

Доступны и gpt-image-2-all, и gpt-image-2-vip — какой из них выбрать?

Оба варианта представляют собой реверс-инжиниринговые каналы с идентичным форматом вызова; -all стоит $0.025 за вызов, а -vip — $0.03 за вызов. Различия заключаются в поддержке size, времени генерации и стабильности:

Не требуется строгий контроль размера, нужен более быстрый и стабильный результат → gpt-image-2-all (~30–60 с, описание размера в prompt, результат 1K–1.5K).
Требуется фиксированный размер на выходе или 4K → gpt-image-2-vip (~90–150 с, 30 фиксированных размеров, включая 4K).
Нужна настройка quality или полное соответствие полям API OpenAI → используйте официальный gpt-image-2.

Можно ли сгенерировать несколько изображений за один раз?

Нет. Эта модель возвращает 1 изображение за вызов. Чтобы получить N изображений, вызовите API N раз параллельно. Каждый вызов тарифицируется отдельно по $0.025.

Поддерживается ли параметр n? Что произойдет, если передать n=3?

Нет. Эта модель возвращает 1 изображение за вызов — для получения нескольких изображений используйте повторные или параллельные запросы.⚠️ Важно: если передать n=3 в запросе, тарификация составит 0.025 × 3 = $0.075, однако фактически будет возвращено только 1 изображение. Обязательно исключите поле n из ваших запросов во избежание лишних списаний.

Если контент отклонен или модель отвечает «I can't do that», списывается ли оплата?

Это реверс-инжиниринговый канал, использующий синхронные ответы в формате чата. Возможны два сценария с разными правилами тарификации:1) Возвращен код HTTP 5xx → НЕ тарифицируетсяКогда политика фильтрации контента вышестоящего провайдера жестко блокирует запрос, вы увидите примерно следующее:

{
  "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 с текстовым «мягким отказом» → ТАРИФИЦИРУЕТСЯКогда модель выдает мягкий отказ в рамках диалога (например, «I can’t do that», «Sorry, this request involves…»), на уровне протокола это выглядит как обычный ответ чата, поэтому вызов тарифицируется. Реверс-канал не может надежно отличить «текст отказа» от «вывода изображения» на уровне протокола.Почему мы не можем просто отменять плату за мягкие отказыАвтоматическая отмена платы за каждый мягкий отказ означала бы, что платформа берет на себя расходы за каждый неудачный вызов вышестоящего провайдера. Что еще важнее, частые срабатывания систем безопасности контента вышестоящего провайдера повышают риск блокировки аккаунта поставщика — это реальные издержки на стороне инфраструктуры, которые невозможно полностью устранить.Рекомендации для интеграторов

✅ Предварительно фильтруйте и предупреждайте пользователей: настройте фильтрацию по ключевым словам и сценариям на фронтенде или шлюзе (имена реальных людей, защищенные авторским правом персонажи, деликатные темы) и показывайте в интерфейсе подсказку вроде: «Запросы об известных личностях и объектах авторского права могут завершиться ошибкой, но все равно будут протарифицированы согласно правилам вышестоящего провайдера». Это значительно сократит лишние списания.
✅ Ежемесячная компенсация для b2c-продуктов: мы понимаем, что в продуктах для конечных пользователей невозможно полностью ограничить пользовательский ввод. Если ваши ежемесячные расходы достаточно высоки (от $1000+/month), вы можете собирать логи раз в месяц (запросы с малой задержкой обычно являются мягкими отказами) и обращаться в поддержку за разовой ручной компенсацией — подавать заявку по каждому вызову отдельно не требуется.

📖 См. также: Ошибки 500 обычно вызваны срабатыванием политики безопасности контента (не тарифицируются)

Нужно ли добавлять префикс data:image/png;base64, к b64_json?

Сначала проверьте, затем обрабатывайте. По состоянию на июль 2026 года возвращаемое значение b64_json представляет собой чистый base64 без префикса data: — декодируйте его для записи в файл или добавьте префикс самостоятельно перед рендерингом; в более ранних версиях префикс присутствовал. Добавьте проверку startsWith('data:') в свой код: если префикс присутствует, используйте значение напрямую как img src; если нет — сначала декодируйте или добавьте префикс. Это предотвратит появление двойного префикса или попытку декодирования строки с префиксом, приводящую к повреждению изображения.

Почему на выходе получается другой размер, даже если в prompt указано 1024x1024?

Адаптивные модели воспринимают указания размера скорее как «рекомендацию», а не жесткое требование. Чтобы повысить точность соблюдения: помещайте слова, задающие размер и композицию, в самое начало prompt и сочетайте их со стилевыми дескрипторами (например, cinematic, phone poster, square composition).Формулировки, которые гарантированно приводят к определенному разрешению, приведены выше на этой странице в таблице «Проверенные формулировки prompt → фактическое разрешение» (в разделе «Управление размером и соотношением сторон»).

Нужно ли сжимать входные изображения? Помогает ли указание 4K / 8K в prompt?

Да, настоятельно рекомендуется. Сжимайте каждое входное изображение до размера менее 1.5MB (качество JPEG 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 в ответе режима url представляет собой ссылку R2 CDN, срок действия которой истекает примерно через 1 день (24 часа) — последующие запросы к ней вернут ошибку 404.Настоятельно рекомендуется: скачивайте и сохраняйте сгенерированные изображения в собственное объектное хранилище (S3 / OSS / R2), CDN или базу данных сразу после генерации. Не используйте полученный URL для постоянных прямых ссылок (hotlinking).Два рекомендуемых подхода:

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

Для кратковременного предпросмотра (отображение в рамках одной сессии) URL R2 можно использовать как есть, без сохранения.

Поддерживается ли потоковая передача?

Нет. Эта модель возвращает изображение целиком за один раз; потоковая передача не поддерживается. Если важна задержка, отображайте индикатор выполнения «генерация…» на стороне клиента и настройте таймаут 300 с (с запасом).

Можно ли использовать официальный SDK OpenAI?

Да. Укажите base_url на https://api.apiyi.com/v1 и задайте свой token APIYI в api_key. Однако client.images.generate() по умолчанию отправляет size/n — эта модель отклоняет оба параметра, поэтому мы рекомендуем выполнять прямые HTTP-запросы с помощью requests / fetch к /v1/images/generations и /v1/images/edits.

Есть ли существенная разница между prompt на китайском и английском языках?

Эта модель нативно поддерживает китайский язык, и результаты сопоставимы. Для специфических китайских сценариев (каллиграфия, элементы традиционных праздников) формулировки на китайском языке выглядят более естественно.

Можно ли по-прежнему генерировать изображения через /v1/chat/completions?

Да, этот эндпоинт по-прежнему работает, но он больше не рекомендуется — используйте вместо него /v1/images/generations и /v1/images/edits (это стабильнее, и тот же код будет работать с официальным релеем gpt-image-2).Формат чата имеет смысл только в двух сценариях: многоэтапное пошаговое редактирование или прямая передача URL онлайн-изображений. Обратите внимание: если намерение сгенерировать изображение неочевидно, модель может вернуть обычный текст вместо изображения (добавьте в начало вашего prompt фиксированный префикс, например «Generate an image:», чтобы подчеркнуть цель).Полный список параметров см. в справочнике по API на базе чата.

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

⚖️ Сравнение официальной версии и reverse-канала — руководство по выбору в сравнении с официальной gpt-image-2
Песочница генерации изображений по тексту — эндпоинт, совместимый с /v1/images/generations
Песочница редактирования изображений — объединение и редактирование нескольких изображений с помощью /v1/images/edits
GPT-Image-2-VIP (та же цена, поддержка size и 4K) — сестринская модель по той же цене с 30 фиксированными размерами (включая 4K); полностью идентичный формат вызова
GPT-Image-2 Official (с тарификацией по token) — для параметра quality / перерисовки по маске / строгого соответствия полям OpenAI-API
Обзор серии GPT-Image — официальное сравнение GPT-Image
Сообщество: ноды Luck GPT-Image 2 для ComfyUI — прямой вызов gpt-image-2-all в ComfyUI (два эндпоинта: chat_completions / images_api)
Сообщество: навыки APIYI GPT-Image 2 — вызов из Codex CLI / Cursor / Gemini CLI и других инструментов разработки на базе ИИ одной фразой
Справочник по API — общие правила выполнения вызовов

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

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

GPT-Image-2.5-All: генерация/редактирование изображений

Обзор

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

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

Поручите интеграцию ИИ-агенту

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

Высококонкурентная цена

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

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

Объединение нескольких изображений

Более быстрая генерация

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

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

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

Тарифы

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

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

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

Эндпоинты

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

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

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

Предоставление этой таблицы конечным пользователям

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

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

Часто задаваемые вопросы (FAQ)

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

​Обзор

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

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

​Поручите интеграцию ИИ-агенту

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

Высококонкурентная цена

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

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

Объединение нескольких изображений

Более быстрая генерация

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

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

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

​Тарифы

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

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

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

​Эндпоинты

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

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

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

​Предоставление этой таблицы конечным пользователям

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

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

​Часто задаваемые вопросы (FAQ)

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

Обзор

Поручите интеграцию ИИ-агенту

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

Тарифы

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

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

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

Эндпоинты

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

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

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

Предоставление этой таблицы конечным пользователям

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

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

Часто задаваемые вопросы (FAQ)

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