Генерация изображений

Текст → изображение POST /v1/images/generations · Изображение → изображение POST /v1/images/edits · Группа токенов media / media-gen

Доступные модели

Название модели	Описание	Разрешение	Референсы
gpt-image-2	Модель изображений OpenAI	1K	≤3
firefly-gpt-image-2	Firefly × GPT image	1K · 2K · 4K	≤6
nano-banana-2	Google, отлично создаёт и редактирует изображения	1K · 2K · 4K	≤6
seedream-4.5	ByteDance Seedream 4.5	2K · 4K	≤6
flux-kontext-max	Flux, силён в редактировании изображений по инструкции	1K	≤4
flux-klein-2	Krea Flux Klein	1K · 2K	≤4
firefly-image-5	Adobe Firefly 5	1K · 2K	≤1
imagine-1.5	Imagine, текст → изображение	2K	—
imagine-1.5pro	Imagine Pro, текст → изображение	4K	—

Разрешение и соотношение сторон задаются параметром size

В API достаточно передать size (ширина x высота в пикселях) — он одновременно задаёт соотношение сторон и уровень разрешения: длинная сторона ≈1024 → 1K, ≈2048 → 2K, ≈3840 → 4K. Пример: "2048x1152" = 2K с соотношением 16:9. В мастерской всё выбирается кликом. Актуальные цены по каждому уровню см. в мастерской генерации.

Проще всего: через мастерскую генерации

1. Откройте мастерскую генерации и оставайтесь на вкладке «🖼 Генерация изображений»
2. Введите свой токен (группа media / media-gen)
3. Выберите модель → напишите промпт → выберите соотношение сторон / разрешение → нажмите «Сгенерировать»
4. Готовое изображение можно сразу скачать, история генераций также сохраняется

Изображение → изображение (референсы)

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

• Мастерская: нажмите на область «Референсы» и загрузите изображения — поддерживается несколько (лимиты см. в таблице выше, каждое ≤8MB)
• API: используйте POST /v1/images/edits (multipart, файловое поле image можно передать несколько раз), см. Вызов через API

Поддерживаемые соотношения сторон

Основные: 1:1 · 16:9 · 9:16 · 4:3 · 3:4; некоторые модели также поддерживают 21:9, 3:2, 2:3 и другие — ориентируйтесь на варианты, которые отображаются для конкретной модели в мастерской генерации.

Как писать промпт

• Пишите конкретно: объект + сцена + стиль + освещение. Пример: «Золотистый ретривер бежит по золотому пшеничному полю на закате, кинематографично, малая глубина резкости»
• Если хотите определённое качество / стиль (реализм, иллюстрация, 3D, киберпанк…) — прямо так и напишите
• Можно писать как на китайском, так и на английском

Подключение к программе

Полный формат API и примеры кода см. в разделе Вызов через API. Если что-то пошло не так — см. Частые ошибки.