Flux Kontext
Генерация изображений Flux Kontext
Генерация и редактирование изображений с помощью модели Flux Kontext, поддержка текст-в-изображение и редактирование изображений
POST
- Модель Flux Kontext для генерации и редактирования изображений
- Выбор модели через параметр
model:flux-kontext-pro(Pro) илиflux-kontext-max(Max, более высокое качество) - Поддержка текст-в-изображение и редактирование изображений
- С эталонным изображением — режим редактирования, без эталонного — текст-в-изображение
- Асинхронный режим, возвращает
task_idдля запроса результата
Авторизация
string
обязательно
Все эндпоинты требуют аутентификации Bearer TokenПолучить API Key: Перейдите на страницу управления API Key для получения вашего API KeyДобавьте в заголовки запроса:
Параметры запроса
string
обязательно
Название модели генерации изображенийВарианты:
flux-kontext-pro- Pro-версияflux-kontext-max- Max-версия, более высокое качество
string
обязательно
Текстовое описание для генерации изображения
string
Соотношение сторон изображенияПо умолчанию:
- С эталонным изображением:
match_input_image(соответствие входному изображению) - Без эталонного:
16:9
string[]
Массив URL эталонных изображений для редактирования⚠️ Поддерживается только формат URL (base64 не поддерживается)
- Публично доступные URL изображений (http:// или https://)
- Используйте эндпоинт загрузки изображений для загрузки локальных изображений и получения URL
- Максимум 1 изображение
- При передаче изображения — режим редактирования, без передачи — режим текст-в-изображение
object
Метаданные для передачи дополнительных настроек
Ответ
string
Уникальный идентификатор задачи для запроса статуса
string
Тип объекта, фиксированное значение
generation.taskstring
Название использованной модели
string
Статус задачи
queued- В очереди на обработкуin_progress- Обрабатываетсяcompleted- Успешно завершеноfailed- Ошибка
integer
Процент выполнения задачи (0-100)
integer
Unix-временная метка создания задачи
object
Метаданные задачи
Примеры использования
Сценарий 1: Текст-в-изображение
Сценарий 2: Редактирование изображения
Сценарий 3: Высококачественная генерация (модель Max)
Запрос результатов задачиГенерация изображений является асинхронной задачей, после отправки возвращается ID задачи. Используйте конечную точку Получить статус изображения для запроса прогресса и результатов генерации.