Skip to main content
POST

Поддерживаемые модели

Если параметр не помечен как доступный только для Flex, приведённые ниже параметры и ограничения по числу пикселей относятся ко всем трём моделям.

Авторизация

string
обязательно
Для всех конечных точек требуется аутентификация с помощью Bearer Token.Получение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить API-ключ.Добавьте его в заголовок запроса:

Тело запроса

string
обязательно
Название модели:
  • flux-2-flex — модель Flex с возможностью точной настройки
  • flux-2-pro — универсальная модель Pro
  • flux-2-max — модель Max с максимальным качеством
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации или редактирования изображения.
string
по умолчанию:"2MP"
Уровень разрешения выходного изображения:
  • 1MP
  • 2MP — по умолчанию
  • 3MP
  • 4MP
Здесь 1MP соответствует 1,048,576 пикселям.Для обратной совместимости поддерживаются псевдонимы: 512, 512P и 1M соответствуют 1MP; 1K и 10242MP; 2K и 20483MP; 4K4MP. Другие значения отклоняются.Фактические размеры также зависят от size. Если одновременно указаны width и height, используются точные размеры в пикселях.
string
по умолчанию:"1:1"
Соотношение сторон или размеры выходного изображения в пикселях.size также поддерживает auto: при передаче image_urls используется соотношение сторон референсного изображения, а текущий уровень resolution сохраняется; без референсного изображения применяется значение по умолчанию 1:1.Поддерживаются следующие варианты размера:
  • 1:1 — квадрат (по умолчанию)
  • 4:3 — горизонтальное
  • 3:4 — вертикальное
  • 16:9 — широкоформатное
  • 9:16 — вертикальное широкоформатное
  • 3:2 — классическое горизонтальное
  • 2:3 — классическое вертикальное
  • 21:9 — сверхширокоформатное
  • 9:21 — сверхвертикальное
  • auto — использовать соотношение сторон референсного изображения
Также можно передать строку с размерами в формате "ширинаxвысота", например "1024x1536".Приоритет параметров размера: пара width + height, затем строка пикселей в size, затем resolution + соотношение сторон в size. Если ничего не указано, используется 2MP + 1:1 (1440×1440).
integer
Точная ширина выходного изображения в пикселях. Необходимо передавать вместе с height; каждое значение должно быть не меньше 64. Если передан только один из параметров, задача завершится с ошибкой.width и height имеют наивысший приоритет и при совместной передаче переопределяют resolution и size.
integer
Точная высота выходного изображения в пикселях. Необходимо передавать вместе с width; каждое значение должно быть не меньше 64. Если передан только один из параметров, задача завершится с ошибкой.Общее число пикселей выходного изображения не должно превышать 4 МП: width × height ≤ 4 194 304.
array
Список референсных изображений для преобразования изображения или объединения нескольких референсов.Ограничения:
  • Не более 8 изображений
  • Поддерживаются общедоступные URL
  • Поддерживаются изображения в формате Base64
  • Суммарное число пикселей выходного изображения и всех референсов не должно превышать 9 МП
string
по умолчанию:"jpeg"
Формат выходного изображения: jpeg, png или webp. Значение по умолчанию — jpeg.
integer
по умолчанию:"1"
Число генерируемых изображений. Поддерживается только значение 1.
integer
Случайное начальное значение. Фиксированный seed при остальных неизменных параметрах позволяет воспроизвести тот же результат; если параметр не передан, значение выбирается случайно.
boolean
по умолчанию:"false"
Включает или отключает улучшение промпта:
  • true — включено
  • false — отключено (по умолчанию); помогает уменьшить отклонение улучшенного промпта от исходного
Явно укажите false, чтобы отключить переформулирование промпта.
integer
по умолчанию:"2"
Уровень допустимости при проверке контента в диапазоне от 0 до 5. Чем выше значение, тем менее строгая проверка применяется.
integer
по умолчанию:"50"
Число шагов семплирования; поддерживается только моделью flux-2-flex. Диапазон: 1–50. Большие значения обычно повышают детализацию, но увеличивают время генерации.
number
по умолчанию:"5.0"
Сила следования промпту; поддерживается только моделью flux-2-flex. Диапазон: 1.5–10. При больших значениях результат обычно точнее следует промпту.

Таблица разрешений

Примеры использования

Базовая генерация по тексту
Генерация с максимальным качеством
Точные размеры в пикселях
Объединение нескольких референсов
Точная настройка Flex

Ответ

После успешной отправки data представляет собой массив. Идентификатор задачи находится в data[0].task_id.
integer
Код состояния ответа.
array
Массив данных ответа.

Получение результата задачи

Задача обрабатывается асинхронно. Используйте task_id из ответа на отправку в следующем запросе, пока статус не изменится на completed или failed:
Возможные статусы задачи: Пример ответа для завершённой задачи:
result.images[].url — массив строк. Модели этой серии генерируют ровно одно изображение за запрос, поэтому используйте url[0]. Срок действия URL изображения определяется Unix-временем expires_at в том же объекте. Сохраните результат до указанного момента. Пример ответа для задачи, завершившейся с ошибкой:
Некорректные параметры модели не возвращают синхронный ответ 400. Отправка возвращает HTTP 200 и task_id, затем при опросе задача переходит в failed. Полная причина всегда находится в error.message; значение error.codetask_failed. За неуспешную задачу средства возвращаются полностью.

Примечания

  1. Ограничение размера: выходное изображение не должно превышать 4 МП; ширина и высота должны составлять не менее 64 пикселей.
  2. Общее ограничение по пикселям: суммарное число пикселей выходного изображения и всех референсов не должно превышать 9 МП.
  3. Требования к референсам: поддерживается не более 8 референсных изображений по общедоступным URL или в формате Base64.
  4. Фиксированное число изображений: параметр n должен иметь значение 1.
  5. Улучшение промпта: prompt_upsampling отключён по умолчанию.
  6. Параметры только для Flex: steps и guidance применимы только к flux-2-flex.
  7. Асинхронная задача: после успешной отправки опрашивайте /v1/tasks/{task_id}, чтобы получить окончательный результат.
  8. Ссылка на результат: срок действия URL изображения определяется полем expires_at в ответе.