Bruk Flux Kontext Pro via Rivya Public API v1 med modell-ID flux-kontext-pro, støttede inndata, parametere, Files API-regler, kreditter og svareksempler.

Tilgjengelig via APITekst eller URL er klar; referansemoduser bruker Files APIBilde

API-modell-ID

flux-kontext-pro

Inndata

text, file

Files API

Kreves for referansemoduser

Basiskreditter

Egenskap

Bilde

Fakturering

FIXED

Promptgrense

Ingen dokumentert promptgrense

Forespørselskontrakt

Send modell-ID-en på toppnivå. Modellspesifikke kontroller hører hjemme i params.

Nøkkel	Type	Påkrevd	Standard	Beskrivelse
model	string	Ja	flux-kontext-pro	Bruk API-modell-ID-en flux-kontext-pro.
prompt	string	Ja	-	Prompttekst for modeller som støtter tekstinndata.
params	object	Nei	-	Modellspesifikt parameterobjekt. Bruk radene nedenfor for tillatte nøkler.
client_request_id	string	Nei	-	Valgfri klient-ID for sporing av forespørsler i systemet ditt.

Modellparametere

Nøkkel	Type	Påkrevd	Standard	Område	Alternativer	Beskrivelse
aspectRatio	select	Nei	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Sideforhold
outputFormat	select	Nei	jpeg	-	jpeg, png	JPEG er mindre, mens PNG er bedre for gjennomsiktighet eller renere tapsfrie kanter.
enableTranslation	select	Nei	true	-	true, false	Auto-oversett prompt
promptUpsampling	select	Nei	false	-	false, true	Når dette er aktivert, lar Rivya modellen utvide og polere prompten din før generering. Det hjelper ofte detaljkvaliteten, men kan også gjøre resultatet mer fortolkende enn den rå prompten.
safetyTolerance	number	Nei	2	min 0 / max 6	-	Styrer hvor streng innholdsmodereringen er. Generering tillater vanligvis et bredere område enn redigering; lavere verdier er strengere, og høyere verdier er mer tillatende.
watermark	text	Nei	-	-	-	Vannmerke

Opplastingspolicy

Last opp referansefiler først, og plasser deretter returnert URL og varighetstoken i params.referenceMediaItems.

Referanseregel

Referansebilde: Last opp opptil 1 bildefil for bilderedigeringsprosjekter.

Maks filer

Godtatte filtyper

image

Varighetstoken

Video- og lydreferanser bør ha durationToken fra /api/v1/files når varighetsverifisering kreves.

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

Minimal forespørsel

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

Referansefilforespørsel

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

Opprettelsessvar

Create-endepunktet returnerer en offentlig oppgave-ID. Poll statusendepunktet til oppgaven lykkes eller mislykkes.

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

Vanlige feil

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Noen moduser krever referanseopplastinger via Files API.

Flux Kontext Pro API-integrasjon