Перейти к основному содержанию
POST
Text-to-Image: generate image from text prompt
Интерактивная Песочница справа поддерживает тестирование в реальном времени. Укажите свой API Key в поле Authorization (формат: Bearer sk-xxx), введите промпт, выберите размер / качество и отправьте запрос.
Сценарий использования: эта страница предназначена для преобразования «текст-в-изображение». Просто введите промпт — загрузка изображения не требуется. Для редактирования эталонного изображения, объединения нескольких изображений или дорисовки по маске используйте эндпоинт редактирования изображений.
🖥️ Ограничение браузерной Песочницы (важно)Этот эндпоинт возвращает необработанную строку base64 (обычно размером в несколько МБ) в ответе. Из-за ограничений отображения в браузере Песочница справа может показать 请求时发生错误: unable to complete request после получения ответа — запрос фактически выполнен успешно; браузер просто не может отобразить настолько длинную строку base64.Рекомендуемый рабочий процесс (подходит для начинающих):
  • Скопируйте приведённый ниже пример для Python / Node.js / cURL и запустите его локально. Код автоматически выполняет base64.b64decode ответа и записывает изображение в файл.
  • Если необходимо использовать Песочницу в браузере, установите size на минимальный уровень (например, 1024x1024), а quality — на low, чтобы уменьшить размер ответа.
Все API изображений являются синхронными — идентификатор задачи для опроса отсутствует, а если клиент отключится, результат будет потерян, хотя запрос всё ещё тарифицируется. Установите достаточно большой тайм-аут для этой модели; см. Основные сведения об API изображений и рекомендации.
⚠️ Неподдерживаемые параметры
  • input_fidelity — все три модели принудительно используют высокую точность; его передача приводит к ошибке 400 (проверено на версии 2.5 2026-09-09: does not support the 'input_fidelity' parameter). При миграции с версии 1.5 просто удалите эту строку.
Выходные данные выше 2560×1440 остаются экспериментальными. Для использования в production предпочтительнее пресеты: 2048x1152 / 2048x2048 / 3840x2160.

Примеры кода

Python (OpenAI SDK)

Python (Необработанные запросы)

cURL

Node.js (Нативный fetch)

Браузерный JavaScript (Прямой рендеринг)

Справочник параметров

Не передавайте устаревшие значения DALL·E standard / hd в параметре quality. Принимаются только шесть официальных значений enum: low / medium / high / xhigh / max / auto (xhigh / max — только для двух моделей 2.5). Устаревшие значения ведут себя нестабильно в зависимости от каналов бэкенда: иногда они сразу завершаются ошибкой 400 (invalid_value), а иногда игнорируются без уведомлений, и запрос выполняется со значением auto (непредсказуемая стоимость). Всегда явно указывайте одно из официальных значений.
Подробные ограничения, допустимые значения и примеры приведены на панели Playground справа — во всех полях enum поддерживается выбор из выпадающего списка.

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

⚠️ b64_json is raw base64, без data:image/...;base64, префикса. Клиент должен:
  • Записать файл: base64.b64decode(b64_str) → записать на диск
  • Отрисовка в браузере: добавьте data:image/png;base64, вручную
По состоянию на июль 2026 года, gpt-image-2-all / gpt-image-2-vip тоже возвращают raw base64, но их ранние версии включали префикс — при использовании кода для разных моделей всегда сначала проверяйте startsWith('data:').
Поле usage отражает фактическое число тарифицируемых tokens для этого вызова. input_tokens_details / output_tokens_details отдельно разбивают tokens текста и изображения (image_tokens всегда равно 0 для обычного text-to-image). Полное описание поля и формулу самостоятельного расчета стоимости см. в разделе Как проверить реальное число tokens для каждого вызова на обзорной странице.

Авторизации

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

API Key obtained from APIYI Console

Тело

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

Model name. gpt-image-2.5-flare (speed-first) / gpt-image-2.5-sunburst (quality- and editing-first) / gpt-image-2 (previous generation) share the same price and parameters; pin a dated snapshot in production

Доступные опции:
gpt-image-2.5-flare,
gpt-image-2.5-sunburst,
gpt-image-2,
gpt-image-2.5-flare-2026-09-08,
gpt-image-2.5-sunburst-2026-09-08
prompt
string
обязательно

Prompt text, up to 32,000 characters (provider limit, counted in characters). Supports both Chinese and English. Place scene description at the front for better adherence.

Maximum string length: 32000
Пример:

"Cyberpunk city at night, neon sign closeup, cinematic frame"

size
string
по умолчанию:auto

Output size. Presets: 1024x1024 / 1536x1024 / 1024x1536 / 2048x2048 / 2048x1152 / 3840x2160 / 2160x3840. Also accepts any valid custom size (max edge ≤ 3840, both multiples of 16, ratio ≤ 3:1, total pixels 0.65–8.3MP).

Пример:

"2048x1152"

quality
enum<string>
по умолчанию:auto

Quality tier. low (sketches/batch), medium (daily), high (final/fine text), xhigh / max (new in 2.5: higher quality and cost, rejected by gpt-image-2), auto (default)

Доступные опции:
auto,
low,
medium,
high,
xhigh,
max
output_format
enum<string>
по умолчанию:png

Output format

Доступные опции:
png,
jpeg,
webp
output_compression
integer

Output compression (0–100), only effective for jpeg/webp

Требуемый диапазон: 0 <= x <= 100
Пример:

85

background
enum<string>
по умолчанию:auto

Background mode. auto (default) / opaque / transparent. transparent requires png or webp (jpeg has no alpha channel)

Доступные опции:
auto,
opaque,
transparent
moderation
enum<string>
по умолчанию:auto

Moderation strength. auto (default) or low

Доступные опции:
auto,
low
n
enum<integer>
по умолчанию:1

Number of images. This model only supports 1

Доступные опции:
1

Ответ

Image generated successfully

created
integer

Unix timestamp

Пример:

1776832476

data
object[]

Generation results (this model returns 1 image per call)

usage
object

Token usage for this call (used for token-based billing)