Použijte Flux Kontext Pro přes Rivya Public API v1 s model id flux-kontext-pro, podporovanými vstupy, parametry, pravidly Files API, kredity a příklady odpovědí.

Dostupné přes APIText nebo URL připraveny; referenční režimy používají Files APIObrázek

ID API modelu

flux-kontext-pro

Vstupy

text, file

Files API

Vyžadováno pro referenční režimy

Základní kredity

Schopnost

Obrázek

Fakturace

FIXED

Limit promptu

Není zdokumentovaný žádný limit promptu

Kontrakt požadavku

Model id posílejte na horní úrovni. Model-specific controls patří do params.

Klíč	Typ	Povinné	Výchozí	Popis
model	string	Ano	flux-kontext-pro	Použijte API model id flux-kontext-pro.
prompt	string	Ano	-	Text promptu pro modely, které podporují textový vstup.
params	object	Ne	-	Objekt parametrů specifických pro model. Povolené klíče najdete v řádcích níže.
client_request_id	string	Ne	-	Volitelné client-side id pro trasování požadavků ve vašem systému.

Parametry modelu

Klíč	Typ	Povinné	Výchozí	Rozsah	Možnosti	Popis
aspectRatio	select	Ne	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Poměr stran
outputFormat	select	Ne	jpeg	-	jpeg, png	JPEG je menší, zatímco PNG je lepší pro průhlednost nebo čistší bezeztrátové hrany.
enableTranslation	select	Ne	true	-	true, false	Automaticky přeložit prompt
promptUpsampling	select	Ne	false	-	false, true	Když je zapnutý, Rivya nechá model před generováním rozšířit a vyleštit váš prompt. Často pomáhá kvalitě detailů, ale výsledek může být také interpretačnější než surový prompt.
safetyTolerance	number	Ne	2	min 0 / max 6	-	Určuje, jak přísná je moderace obsahu. Generování obvykle dovoluje širší rozsah než editace; nižší hodnoty jsou přísnější a vyšší hodnoty jsou volnější.
watermark	text	Ne	-	-	-	Watermark

Pravidla nahrávání

Nejprve nahrajte referenční soubory a potom vložte vrácenou URL a duration token do params.referenceMediaItems.

Pravidlo reference

Referenční obrázek: Nahrajte až 1 obrazový soubor pro projekty úprav obrázků.

Max. souborů

Přijímané typy souborů

image

Token délky trvání

Video a audio reference by měly nést durationToken z /api/v1/files, když je vyžadováno ověření délky.

kind	Max. velikost	MIME typy
image	10 MB	image/jpeg, image/png, image/webp

Minimální požadavek

{
  "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": "Volitelný text watermarku"
  }
}

Požadavek s referenčním souborem

{
  "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": "Volitelný text watermarku",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Odpověď vytvoření

Create endpoint vrátí public task id. Pollujte status endpoint, dokud úloha neuspěje nebo neselže.

{
  "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
}

Běžné chyby

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Některé režimy vyžadují referenční nahrání přes Files API.

API integrace Flux Kontext Pro