Gebruik Flux Kontext Pro via Rivya Public API v1 met model-id flux-kontext-pro, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekst of URL gereed; referentiemodi gebruiken Files APIAfbeelding

API-model-id

flux-kontext-pro

Inputs

text, file

Files API

Vereist voor referentiemodi

Basiscredits

Mogelijkheid

Afbeelding

Facturering

FIXED

Promptlimiet

Geen gedocumenteerde promptlimiet

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	flux-kontext-pro	Gebruik de API-model-id flux-kontext-pro.
prompt	string	Ja	-	Prompttekst voor modellen die tekstinput ondersteunen.
params	object	Nee	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
aspectRatio	select	Nee	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Beeldverhouding
outputFormat	select	Nee	jpeg	-	jpeg, png	JPEG is kleiner, terwijl PNG beter is voor transparantie of schonere verliesloze randen.
enableTranslation	select	Nee	true	-	true, false	Prompt automatisch vertalen
promptUpsampling	select	Nee	false	-	false, true	Wanneer dit is ingeschakeld, laat Rivya het model je prompt uitbreiden en verfijnen voor de generatie. Dat helpt vaak bij detailkwaliteit, maar kan het resultaat ook vrijer laten interpreteren dan je ruwe prompt.
safetyTolerance	number	Nee	2	min 0 / max 6	-	Bepaalt hoe streng de contentmoderatie is. Generatie laat meestal meer ruimte dan bewerking; lagere waarden zijn strenger en hogere waarden zijn permissiever.
watermark	text	Nee	-	-	-	Watermerk

Uploadbeleid

Upload eerst referentiebestanden en plaats daarna de teruggegeven URL en duration token in params.referenceMediaItems.

Referentieregel

Referentiebeeld: Upload maximaal 1 beeldbestand voor beeldbewerkingsprojecten.

Max. bestanden

Geaccepteerde bestandstypen

image

Duurtoken

Video- en audioreferenties moeten durationToken uit /api/v1/files bevatten wanneer duurverificatie vereist is.

kind	Max. grootte	MIME-types
image	10 MB	image/jpeg, image/png, image/webp

Minimale request

{
  "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": "Optionele watermerktekst"
  }
}

Request met referentiebestand

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

Create-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

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

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sommige modi vereisen referentie-uploads via Files API.

Flux Kontext Pro API-integratie