Используйте Flux Kontext Pro через Rivya Public API v1: ID модели flux-kontext-pro, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.

Доступно через APIТекст или URL готовы; референсные режимы используют Files APIИзображение

ID модели API

flux-kontext-pro

Входные данные

text, file

Files API

Требуется для референсных режимов

Базовые кредиты

Ставка в кредитах: 4 / изображение Итоговая стоимость задачи округляется вверх до целых кредитов.

Возможность

Изображение

Биллинг

FIXED

Лимит промпта

Документированный лимит промпта отсутствует

Контракт запроса

Передавайте ID модели на верхнем уровне. Управляющие параметры конкретной модели размещайте в params.

Ключ	Тип	Обязательно	По умолчанию	Описание
model	string	Да	flux-kontext-pro	Используйте flux-kontext-pro как ID модели API.
prompt	string	Да	-	Текст промпта для моделей, поддерживающих текстовый ввод.
params	object	Нет	-	Объект параметров конкретной модели. Допустимые ключи указаны в таблице ниже.
client_request_id	string	Нет	-	Необязательный клиентский id для трассировки запросов в вашей системе.

Параметры модели

Ключ	Тип	Обязательно	По умолчанию	Диапазон	Варианты	Описание
aspectRatio	select	Нет	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Соотношение сторон
outputFormat	select	Нет	jpeg	-	jpeg, png	JPEG меньше по размеру, а PNG лучше подходит для прозрачности или более чистых краев без потерь.
enableTranslation	select	Нет	true	-	true, false	Автоперевод промпта
promptUpsampling	select	Нет	false	-	false, true	Когда включено, Rivya позволяет модели расширить и отполировать ваш промпт перед генерацией. Это часто помогает качеству деталей, но может сделать результат более вольным, чем исходный промпт.
safetyTolerance	number	Нет	2	min 0 / max 6	-	Управляет строгостью модерации контента. Генерация обычно допускает более широкий диапазон, чем редактирование; меньшие значения строже, большие — менее строгие.
watermark	text	Нет	-	-	-	Водяной знак

Политика загрузки

Сначала загрузите референсные файлы, затем поместите возвращенный URL и токен длительности в params.referenceMediaItems.

Правило референсных материалов

Референсное изображение: Загрузите один файл изображения для проектов редактирования изображений.

Макс. файлов

Принимаемые типы файлов

image

Токен длительности

Видео- и аудио-референсы должны передавать поле durationToken из /api/v1/files, когда требуется проверка длительности.

kind	Макс. размер	MIME-типы
image	10 MB	image/jpeg, image/png, image/webp

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

{
  "model": "flux-kontext-pro",
  "prompt": "Флакон продукта на светло-сером фоне с мягким освещением слева.",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Необязательный текст водяного знака"
  }
}

Запрос с референсным файлом

{
  "model": "flux-kontext-pro",
  "prompt": "Флакон продукта на светло-сером фоне с мягким освещением слева.",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Необязательный текст водяного знака",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Ответ создания

Эндпоинт создания возвращает публичный id задачи. Опрашивайте эндпоинт статуса, пока задача не завершится успехом или ошибкой.

{
  "id": "task_flux_kontext_pro_example",
  "status": "queued",
  "model": "flux-kontext-pro",
  "reserved_credits": 4,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Распространенные ошибки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Некоторым режимам нужны референсные файлы, загруженные через Files API.

Интеграция Flux Kontext Pro API