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

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

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

Название модели	Описание	Разрешение	Референсы
gpt-image-2	Модель изображений OpenAI · Одна цена для 1K / 2K / 4K	1K · 2K · 4K	≤6
gpt-image-2.5	Модель изображений OpenAI (новое поколение) · Одна цена для 1K / 2K / 4K	1K · 2K · 4K	≤6
gemini-3.0-pro-image-ultra	Google Gemini 3 Pro Image (Nano Banana Pro) · Одна цена для 1K / 2K / 4K	1K · 2K · 4K	≤1
gemini-3.1-flash-image-ultra	Google Gemini 3.1 Flash Image (Nano Banana 2) · Одна цена для 1K / 2K / 4K	1K · 2K · 4K	≤1
gemini-nano-banana-2.1-ultra	Google Nano Banana 2.1 · Одна цена для 1K / 2K / 4K	1K · 2K · 4K	≤1

Три модели Gemini используют POST /v1beta/models/{model}:generateContent. Запрос и референс передаются в contents[].parts, формат — в generationConfig.imageConfig (aspectRatio / imageSize: "1K" / "2K" / "4K"). Результат в candidates[].content.parts: inlineData (base64) или fileData.fileUri (URL). Мастерская обрабатывает оба формата.

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

В API передайте size (ширина x высота в пикселях), чтобы задать соотношение сторон. Примеры: "1024x1024" = 1:1, "1024x576" = 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. Если что-то пошло не так — см. Частые ошибки.