FLUX 3 Image

Модель flux-3-image создаёт одно изображение по тексту либо редактирует переданные референсы. Это отдельная модель от FLUX 3 Video.

Минимальный запрос


curl -X POST https://api.apihubs.ru/api/v1/generation/create \
  -H "Authorization: Bearer $API_STOCK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image",
    "input": {
      "prompt": "Фотореалистичный керамический чайник на светлом фоне",
      "size": "16:9",
      "resolution": "1K"
    }
  }'

Ответ содержит data.taskId. Опрашивайте GET /api/v1/task/status/$TASK_ID либо передайте webhook на верхнем уровне запроса. Готовое изображение возвращается в data.files[].fileUrl.

Параметры

Параметры передаются внутри input.

Параметр	Тип	По умолчанию	Назначение
`prompt`	string	обязателен	Описание изображения или инструкции по редактированию.
`urls`	string[]	—	До 10 публичных HTTP(S) URL референсов. Без них выполняется генерация по тексту.
`size`	string	`auto`	Соотношение сторон. Auto следует первому референсу или выбирает пропорции по промпту.
`resolution`	string	`1K`	Тариф разрешения: `768SQ`, `1K`, `1.5K`, `2K`, `4K`.
`grounding`	boolean	`true`	Разрешить поиск в интернете и поиск изображений перед генерацией.

Соотношения сторон: 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21 и auto. Поля n, seed, outputFormat, отрицательный промпт и маска не доступны. Каждый запрос создаёт одно изображение; для нескольких создайте отдельные задачи. Цена зависит от разрешения, референсы и поиск не оплачиваются отдельно. Актуальные цены доступны в каталоге и на странице тарифов.

Редактирование


{
  "model": "flux-3-image",
  "input": {
    "prompt": "Сделай чайник синим, сохрани фон и композицию",
    "urls": ["https://example.com/teapot.jpg"],
    "size": "auto",
    "resolution": "2K",
    "grounding": false
  }
}

Для нескольких референсов укажите их назначение в промпте, например «перенеси объект из Image 1 в окружение Image 2». Инструкции по размещению и ограничивающим рамкам задаются внутри строки prompt, отдельного поля маски нет. Генерация 4K может занять несколько минут.

При ошибке провайдера задача повторяется; после исчерпания попыток средства возвращаются. Проверка контента настроена внутри интеграции; её уровень не задаётся через публичный API. Правила контента провайдера продолжают действовать.