Brug Flux Kontext Pro via Rivya Public API v1 med model-id flux-kontext-pro, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekst eller URL klar; referencetilstande bruger Files APIBillede

API-model-id

flux-kontext-pro

Inputs

text, file

Files API

Krævet for referencetilstande

Basiscredits

Funktion

Billede

Fakturering

FIXED

Promptgrænse

Ingen dokumenteret promptgrænse

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

Nøgle	Type	Krævet	Standard	Beskrivelse
model	string	Ja	flux-kontext-pro	Brug API-model-id'et flux-kontext-pro.
prompt	string	Ja	-	Prompttekst til modeller, der understøtter tekstinput.
params	object	Nej	-	Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_id	string	Nej	-	Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

Nøgle	Type	Krævet	Standard	Interval	Valgmuligheder	Beskrivelse
aspectRatio	select	Nej	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Billedformat
outputFormat	select	Nej	jpeg	-	jpeg, png	JPEG er mindre, mens PNG er bedre til gennemsigtighed eller renere tabsfri kanter.
enableTranslation	select	Nej	true	-	true, false	Oversæt prompt automatisk
promptUpsampling	select	Nej	false	-	false, true	Når det er aktiveret, lader Rivya modellen udvide og polere din prompt før generering. Det hjælper ofte detaljekvaliteten, men kan også gøre resultatet mere fortolkende end din rå prompt.
safetyTolerance	number	Nej	2	min 0 / max 6	-	Styrer, hvor streng indholdsmodereringen er. Generering tillader normalt et bredere interval end redigering; lavere værdier er strengere, og højere værdier er mere tilladende.
watermark	text	Nej	-	-	-	Vandmærke

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Referencebillede: Upload op til 1 billedfil til billedredigeringsprojekter.

Maks. filer

Accepterede filtyper

image

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kind	Maks. størrelse	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp

Minimal anmodning

{
  "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": "Valgfri vandmærketekst"
  }
}

Referencefilanmodning

{
  "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": "Valgfri vandmærketekst",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

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

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.

Flux Kontext Pro API-integration