FLUX.1 Kontext [pro]

flux-kontext-pro FLUX.1 Kontext [pro] помогает объединять референсные изображения и текстовые указания для контролируемой генерации сцен. Она полезна для исследования макетов, визуальных миксов и дизайна на основе референсов.

Эндпоинты

POST /v1/queue/flux-kontext-pro # Создать задачу

GET /v1/queue/flux-kontext-pro/requests/{request_id}/status # Проверить статус

GET /v1/queue/flux-kontext-pro/requests/{request_id}/response # Получить результат

PUT /v1/queue/flux-kontext-pro/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --location "https://api.odirouter.ai/model/v1/queue/flux-kontext-pro" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A clean product photo of a red apple on a white table, soft studio lighting.",
    "seed": 42,
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_upsampling": false,
    "safety_tolerance": 2
  }'

prompt string

Текстовое описание желаемого изображения.

input_image string

Base64-encoded image или image URL, используемый как reference. Поддерживается размер до 20MB.

input_image_2 string

Base64-encoded image или image URL, используемый как reference. Поддерживается размер до 20MB.

input_image_3 string

Base64-encoded image или image URL, используемый как reference. Поддерживается размер до 20MB.

input_image_4 string

Base64-encoded image или image URL, используемый как reference. Поддерживается размер до 20MB.

seed int

Используется для воспроизводимости. Если передано null или поле не указано, используется случайный seed. Принимает любое целое число, например 42.

aspect_ratio string

Aspect ratio изображения в диапазоне от 21:9 до 9:21.

output_format string

Формат вывода. Значение jpeg принимается, но возвращенный файл может остаться в формате png.

Варианты: jpeg, png

По умолчанию: png

prompt_upsampling bool

Включает upsampling prompt. Когда настройка включена, prompt автоматически изменяется для более творческой генерации.

По умолчанию: false

safety_tolerance any

Уровень safety tolerance для модерации входных и выходных данных. 0 - самый строгий, 6 - самый мягкий.

Диапазон: 0 <= x <= 6

По умолчанию: 2

Параметры ответа

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/flux-kontext-pro/requests/mmsu_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/flux-kontext-pro/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/flux-kontext-pro/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	Идентификатор задачи, используемый во всех последующих операциях.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции