Flux Kontext
Генерация изображений Flux Kontext
-
Асинхронная обработка: после отправки возвращается идентификатор задачи для последующего запроса
-
Модели Pro и Max поддерживают генерацию по тексту и редактирование по референсным изображениям
-
Поле
expires_atв результате указывает время истечения срока действия ссылки на изображение
POST
Поддерживаемые модели
Авторизация
string
обязательно
Для всех конечных точек требуется аутентификация с помощью Bearer Token.Получение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить API-ключ.Добавьте его в заголовок запроса:
Тело запроса
string
обязательно
Название модели:
flux-kontext-pro— Kontext Pro для генерации и редактирования изображенийflux-kontext-max— Kontext Max для генерации и редактирования изображений с повышенным качеством
string
обязательно
Текстовое описание для генерации или редактирования изображения.
array
Список референсных изображений. Без этого параметра выполняется генерация по тексту; при его наличии изображения редактируются.Ограничения:
- Не более 4 изображений
- Поддерживаются общедоступные URL
- Поддерживаются изображения в формате Base64
- Суммарное число пикселей выходного изображения и всех референсов не должно превышать 9 МП
temporarily unavailable dependency. В таком случае сначала проверьте, что URL общедоступен, не истёк и не блокирует внешний доступ.string
по умолчанию:"1:1"
Соотношение сторон изображения.Поддерживаемые соотношения сторон:
1:1— квадрат (по умолчанию)4:3— горизонтальное 4:33:4— вертикальное 3:416:9— широкоформатное горизонтальное9:16— широкоформатное вертикальное3:2— горизонтальное 3:22:3— вертикальное 2:321:9— сверхширокое9:21— сверхвысокое
1024x1536. Kontext сопоставляет её с ближайшим поддерживаемым соотношением сторон и не гарантирует точные указанные размеры.Параметр resolution не влияет на результат Kontext, который остаётся около 1 МП. Не передавайте width или height: Kontext не поддерживает эти параметры, и задача завершится с ошибкой.string
по умолчанию:"png"
Формат выходного изображения:
png— PNG (по умолчанию)jpeg— JPEGwebp— WebP
string
Совместимый параметр формы ответа. Допустимые значения:
url и b64_json. Он не изменяет формат изображения; если также передан output_format, приоритет имеет output_format.integer
по умолчанию:"1"
Число генерируемых изображений. Поддерживается только значение
1.integer
Случайное начальное значение. Фиксированный seed при остальных неизменных параметрах позволяет воспроизвести тот же результат; если параметр не передан, значение выбирается случайно.
boolean
по умолчанию:"false"
Включает или отключает улучшение промпта:
true— включеноfalse— отключено (по умолчанию)
Явно укажите false, чтобы отключить переформулирование промпта.
integer
по умолчанию:"2"
Уровень допустимости при проверке контента.Диапазон: 0–6. Чем выше значение, тем менее строгая проверка применяется.
Фактические размеры результата
Примеры использования
Редактирование по входному изображениюОтвет
integer
Код состояния ответа.
array
Массив данных ответа.
Получение результата задачи
После успешной отправки опрашивайте статус задачи черезGET /v1/tasks/{task_id}. Подробности приведены на странице получения статуса задачи.
Пример успешного ответа
data.result.images[0].url[0]. expires_at — Unix-время истечения срока действия этой ссылки. Сохраните изображение до указанного момента.
Статусы задачи
Пример ответа с ошибкой
task_id, затем при опросе задача переходит в failed. Полная причина всегда находится в error.message; значение error.code — task_failed. За неуспешную задачу средства возвращаются полностью.
Примечания
- Асинхронная обработка: после отправки возвращается
task_id. Опрашивайте/v1/tasks/{task_id}, чтобы получить результат. - Требования к референсам: поддерживается до 4 референсных изображений по общедоступным URL или в формате Base64; суммарный объём выхода и всех референсов не должен превышать 9 МП.
- Правила размера: соотношение по умолчанию —
1:1;resolutionне влияет на результат, аwidthиheightне поддерживаются. - Число изображений: параметр
nдолжен иметь значение1. - Переформулирование промпта: явно укажите
prompt_upsampling: false, чтобы отключить переформулирование промпта. - Ссылка на результат: срок действия URL изображения определяется соответствующим Unix-временем
expires_at. Сохраните изображение до истечения срока.