Використовуйте 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

Потрібно для референсних режимів

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

Можливість

Зображення

Білінг

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.

Правило референсів

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

Максимум файлів

Прийняті типи файлів

image

Токен тривалості

Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.

kind	Максимальний розмір	MIME types
image	10 MB	image/jpeg, image/png, image/webp

Мінімальний запит

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Опційний текст водяного знака"
  }
}

Запит із референсним файлом

{
  "model": "flux-kontext-pro",
  "prompt": "A clean editorial product image on a soft studio background",
  "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,
  "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.

API-інтеграція для Flux Kontext Pro