Skip to main content
POST
Text-to-Image: generate at an explicit size from a text prompt
Интерактивная песочница справа поддерживает прямое онлайн-тестирование. Введите ваш API Key в поле Authorization (формат: Bearer sk-xxx), задайте prompt и size, затем нажмите «Отправить».
Область применения: Эта страница предназначена для генерации изображений по тексту. Просто введите prompt и size — загрузка изображения не требуется. Чтобы редактировать или объединять существующие изображения, используйте эндпоинт Image Editing.Отличие от gpt-image-2-all: идентичная структура вызова, только на одно дополнительное поле size. Если вам не нужно жестко фиксировать размеры и нужен максимально быстрый результат, используйте gpt-image-2-all вместо этого.
🖥️ Ограничение браузерной песочницыЭтот эндпоинт по умолчанию возвращает base64-строку (b64_json), которая может занимать несколько МБ, поэтому в браузерной песочнице может отображаться 请求时发生错误: unable to complete requestна самом деле запрос выполнен успешно; браузер просто не может отрисовать такую длинную base64-строку.Рекомендуемый рабочий процесс: скопируйте пример кода ниже и запустите его локально — он автоматически декодирует изображение и сохранит его в файл.
Все image API являются синхронными — здесь нет task ID для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицирован. Установите для этой модели достаточно большой timeout; см. Основы и лучшие практики Image API.
⚠️ Важные примечания по параметрам
  • size: передайте auto, чтобы модель выбрала размер сама (vip обычно сходится к относительно фиксированному/стабильному размеру для данного prompt), либо выберите один из 30 поддерживаемых размеров (10 соотношений сторон × 1K Fast / 2K Recommended / 4K Detail — см. полную таблицу размеров на странице обзора) для жесткой фиксации. Используйте строчные ASCII x, например 2048x1360, 3840x2160 — никогда не × и не заглавные X.
  • quality: ❌ отклоняется — не передавайте.
  • n: ❌ отклоняется — по одному изображению за вызов. Отправка n=3 тарифицируется в 3×, но все равно возвращается 1 изображение. Уберите это поле.
  • aspect_ratio: ❌ отклоняется — соотношение сторон определяется size.
  • response_format: если не указывать, возвращается base64 (raw, без префикса, проверено 2026-07); передайте "url" для получения URL изображения. Компаниям, которым нужен предсказуемый вывод URL, следует переключить свой token на группу image2_OSS, чтобы получать детерминированный вывод URL без fallback на base64.

Примеры кода

Python

Пример уровня 4K Detail (обои / печать):

cURL

Node.js

OpenAI SDK (Python, рекомендуется)

Параметры

Шпаргалка по размерам — они покрывают большинство случаев:
  • Главные изображения для e-commerce: 2048x1360 (3:2 2K) / 2048x2048 (1:1 2K)
  • Вертикальные постеры: 1536x2048 (3:4 2K) / 2480x3312 (3:4 4K)
  • Миниатюры видео: 2048x1152 (16:9 2K) / 3840x2160 (16:9 4K)
  • Stories / обои для телефона: 1152x2048 (9:16 2K) / 2160x3840 (9:16 4K)
Полная таблица из 30 размеров: страница обзора.

Формат ответа

По умолчанию возвращается base64 (data[0].b64_json, raw base64 без префикса, проверено в 2026-07). Чтобы вместо этого получить image URL, явно передайте response_format: "url"; компаниям, которым нужен вывод по URL, следует переключить группу своего token на image2_OSS для стабильного вывода URL без fallback на base64. data[0] возвращает либо url, либо b64_json — никогда оба сразу. Режим b64_json (по умолчанию):
Режим url (явно передайте response_format: "url"; используйте группу image2_OSS, если вы зависите от URL — R2 CDN globally accelerated):
Примечание о совместимости: проверено в июле 2026 — поле b64_json представляет собой raw base64 без префикса data:; декодируйте его, чтобы записать файл, или добавьте префикс вручную перед рендерингом. В более ранних версиях префикс действительно присутствовал, поэтому всегда сначала выполняйте проверку startsWith('data:'), чтобы поддерживать оба варианта.

Связанные ресурсы

Обзор модели (полная таблица размеров)

Полная таблица из 30 размеров, цены, технические характеристики

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

/v1/images/edits объединение нескольких изображений и редактирование

Смежная модель gpt-image-2-all

Тот же формат вызова, если вам не нужен фиксированный размер — более быстрый вывод (~30–60s)

Авторизации

Authorization
string
header
обязательно

API Key from the API易 Console

Тело

application/json
model
enum<string>
по умолчанию:gpt-image-2-vip
обязательно

Model name, fixed to gpt-image-2-vip

Доступные опции:
gpt-image-2-vip
prompt
string
обязательно

Prompt — describe content, style, lighting, etc.

Пример:

"Cinematic landscape, old lighthouse by the sea at dusk, photorealistic"

size
enum<string>

Output size. Pass auto to let the model decide (vip tends to converge on a relatively fixed size for a given prompt), or pick one of the 30 supported sizes (10 ratios × 1K Fast / 2K Recommended / 4K Detail) to lock it strictly. Format: WIDTHxHEIGHT with lowercase ASCII x, e.g., 2048x1360, 3840x2160. Flat $0.03/image across all tiers.

Доступные опции:
auto,
1280x1280,
848x1280,
1280x848,
960x1280,
1280x960,
1024x1280,
1280x1024,
720x1280,
1280x720,
1280x544,
2048x2048,
1360x2048,
2048x1360,
1536x2048,
2048x1536,
1632x2048,
2048x1632,
1152x2048,
2048x1152,
2048x864,
2880x2880,
2336x3520,
3520x2336,
2480x3312,
3312x2480,
2560x3216,
3216x2560,
2160x3840,
3840x2160,
3840x1632
Пример:

"2048x1152"

Ответ

Image successfully generated. Defaults to base64 in data[0].b64_jsonurl is not returned in the same response.

Image generation response. Returns base64 by default (data[0].b64_json); to get a url, switch to the image2_OSS group with response_format=url. data[0] returns either url or b64_json, never both.

data
object[]

Result array (this model returns 1 image per call)

created
integer

Unix timestamp (seconds)

usage
object

Token usage statistics