Använd Flux Kontext Max via Rivyas publika API v1 med modell-ID flux-kontext-max, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIText eller URL klar; referenslägen använder Files APIBild

API-modell-ID

flux-kontext-max

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

Förmåga

Bild

Fakturering

FIXED

Promptgräns

Ingen dokumenterad promptgräns

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

Nyckel	Typ	Obligatoriskt	Standard	Beskrivning
model	string	Ja	flux-kontext-max	Använd API-modell-ID:t flux-kontext-max.
prompt	string	Ja	-	Prompttext för modeller som stöder textinmatning.
params	object	Nej	-	Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_id	string	Nej	-	Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

Nyckel	Typ	Obligatoriskt	Standard	Intervall	Alternativ	Beskrivning
aspectRatio	select	Nej	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Bildförhållande
outputFormat	select	Nej	jpeg	-	jpeg, png	JPEG är mindre, medan PNG är bättre för transparens eller renare förlustfria kanter.
enableTranslation	select	Nej	true	-	true, false	Autoöversätt prompt
promptUpsampling	select	Nej	false	-	false, true	När detta är aktiverat låter Rivya modellen expandera och putsa din prompt före generering. Det hjälper ofta detaljkvaliteten, men kan också göra resultatet mer tolkande än din råa prompt.
safetyTolerance	number	Nej	2	min 0 / max 6	-	Styr hur strikt innehållsmodereringen är. Generering tillåter vanligtvis ett bredare spann än redigering; lägre värden är striktare och högre värden är mer tillåtande.
watermark	text	Nej	-	-	-	Vattenmärke

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Referensbild: Ladda upp upp till 1 bildfil för bildredigeringsprojekt.

Max filer

Godkända filtyper

image

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kind	Max storlek	MIME-typer
image	10 MB	image/jpeg, image/png, image/webp

Minimal begäran

{
  "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": "Valfri vattenmärkestext"
  }
}

Begäran med referensfil

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

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.

Flux Kontext Max API-integration