Używaj Flux Kontext Max przez Rivya Public API v1 z identyfikatorem modelu flux-kontext-max, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APITekst lub URL gotowe; tryby referencyjne używają Files APIImage

Identyfikator modelu API

flux-kontext-max

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

Możliwość

Image

Rozliczenia

FIXED

Limit promptu

Brak udokumentowanego limitu promptu

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	flux-kontext-max	Użyj flux-kontext-max jako identyfikatora modelu API.
prompt	string	Tak	-	Tekst promptu dla modeli obsługujących wejście tekstowe.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
aspectRatio	select	Nie	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Proporcje obrazu
outputFormat	select	Nie	jpeg	-	jpeg, png	JPEG jest mniejszy, a PNG lepszy do przezroczystości lub czystszych bezstratnych krawędzi.
enableTranslation	select	Nie	true	-	true, false	Automatycznie tłumacz prompt
promptUpsampling	select	Nie	false	-	false, true	Po włączeniu Rivya pozwala modelowi rozwinąć i dopracować prompt przed generowaniem. Często pomaga w jakości detali, ale może też sprawić, że wynik będzie bardziej interpretacyjny niż surowy prompt.
safetyTolerance	number	Nie	2	min 0 / max 6	-	Kontroluje, jak rygorystyczna jest moderacja treści. Generowanie zwykle dopuszcza szerszy zakres niż edycja; niższe wartości są bardziej rygorystyczne, a wyższe bardziej liberalne.
watermark	text	Nie	-	-	-	Znak wodny

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Obraz referencyjny: Prześlij maksymalnie 1 plik obrazu dla projektów edycji obrazu.

Maks. plików

Akceptowane rodzaje plików

image

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kind	Maks. rozmiar	Typy MIME
image	10 MB	image/jpeg, image/png, image/webp

Żądanie minimalne

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Opcjonalny tekst znaku wodnego"
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "flux-kontext-max",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspectRatio": "16:9",
    "outputFormat": "jpeg",
    "enableTranslation": "true",
    "promptUpsampling": "false",
    "safetyTolerance": 2,
    "watermark": "Opcjonalny tekst znaku wodnego",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się sukcesem albo błędem.

{
  "id": "task_flux_kontext_max_example",
  "status": "queued",
  "model": "flux-kontext-max",
  "reserved_credits": 8,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.

Integracja API Flux Kontext Max