Skip to main content
POST
Text-to-Image: generate an image from a text prompt
Интерактивная песочница справа поддерживает прямое онлайн-тестирование. Введите свой API Key в поле Authorization (формат: Bearer sk-xxx), введите prompt и нажмите отправку.
Область применения: эта страница предназначена для генерации изображений по тексту. Просто введите prompt — загрузка изображения не требуется. Чтобы редактировать или объединять существующие изображения, используйте эндпоинт редактирования изображений.
🖥️ Ограничение песочницы в браузере (режим b64_json по умолчанию)Этот эндпоинт по умолчанию использует response_format: "b64_json", поэтому ответ содержит base64-строку размером в несколько МБ, и браузерная песочница может показать 请求时发生错误: unable to complete requestзапрос на самом деле выполнен успешно; браузер просто не может отрисовать такую длинную base64-строку.Рекомендуемый порядок работы:
  • Хотите просто посмотреть изображение в Playground? Укажите "response_format": "url" явно — в ответе будет одна ссылка R2, и все отобразится корректно.
  • Нужен base64? Скопируйте кодовый пример ниже и запустите его локально — код автоматически декодирует изображение и сохранит его в файл.
Все API изображений работают синхронно — task ID для опроса отсутствует, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицирован. Задайте этому модели достаточно большой timeout; см. Основы Image API и лучшие практики.
⚠️ Поддержка параметров
  • size: поле не влияет на результат — отправка auto или любого конкретного значения не вызывает ошибку, но значение молча игнорируется сервером. Размеры полностью задаются prompt:
    • В prompt указаны размер или соотношение сторон (например, «Landscape 16:9») → модель следует prompt
    • В prompt нет указаний на размер → один и тот же prompt дает разные размеры в разных вызовах, как будто вы «тянете разные карты» — это полезно для поиска нескольких вариантов композиции
    • Для строгой фиксации размера используйте gpt-image-2-vip (поддерживает auto + 30 явных размеров)
  • n / quality / aspect_ratio: ❌ отклоняется. Отправка этих параметров может вызвать ошибки проверки параметров.
Указывайте размер и соотношение сторон прямо в prompt, например:
  • Landscape 16:9 cinematic, old lighthouse by the sea at dusk
  • Portrait 9:16 phone wallpaper, cyberpunk city rainy night
  • 1024×1024 square logo, minimalist cat line art
Размещайте описание размера в начале prompt для лучшего соответствия.

Примеры кода

Python

режим b64_json (возвращает данные изображения в base64):

cURL

Node.js

JavaScript в браузере (Fetch)

Краткий справочник параметров

Подробные ограничения параметров и допустимые значения показаны в правой панели Playground. Поле response_format поддерживает выбор из выпадающего списка.

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

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

Авторизации

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

API Key from the API易 Console

Тело

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

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

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

Prompt. Include size/ratio/style here, e.g., Landscape 16:9 cinematic, old lighthouse at sunset

Пример:

"Landscape 16:9 cinematic, old lighthouse at sunset"

response_format
enum<string>
по умолчанию:b64_json

Response format. b64_json returns a base64 string already prefixed with a data URL header (default); url returns an R2 CDN link

Доступные опции:
b64_json,
url

Ответ

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

Image generation response. data[0] returns either url or b64_json, never both (depends on response_format; this endpoint defaults to b64_json).

data
object[]

Result array (this model returns 1 image per call)

created
integer

Unix timestamp (seconds)

usage
object

Token usage statistics