Skip to main content
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). Устаревшие значения ведут себя непредсказуемо в разных backend-каналах: иногда они сразу завершаются ошибкой 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. Supports both Chinese and English. Place scene description at the front for better adherence.

Пример:

"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) or opaque. Not supported: transparent

Доступные опции:
auto,
opaque
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)