Nutze Flux Kontext Pro über Rivya Public API v1 mit Model-ID flux-kontext-pro, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarText oder URL bereit; Referenzmodi nutzen Files APIBild

API-Modell-ID

flux-kontext-pro

Eingaben

text, file

Files API

Für Referenzmodi erforderlich

Basis-Credits

Fähigkeit

Bild

Abrechnung

FIXED

Prompt-Limit

Kein dokumentiertes Prompt-Limit

Request-Kontrakt

Sende die Modell-ID auf Top-Level. Modellspezifische Controls gehören in params.

Key	Typ	Erforderlich	Standard	Beschreibung
model	string	Ja	flux-kontext-pro	Verwende flux-kontext-pro als API-Modell-ID.
prompt	string	Ja	-	Prompt-Text für Modelle, die Texteingabe unterstützen.
params	object	Nein	-	Modellspezifisches Parameterobjekt. Die erlaubten Keys stehen in den Zeilen darunter.
client_request_id	string	Nein	-	Optionale Client-ID, um Requests in deinem System nachzuverfolgen.

Modellparameter

Key	Typ	Erforderlich	Standard	Bereich	Optionen	Beschreibung
aspectRatio	select	Nein	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Seitenverhältnis
outputFormat	select	Nein	jpeg	-	jpeg, png	JPEG ist kleiner, während PNG besser für Transparenz oder sauberere verlustfreie Kanten ist.
enableTranslation	select	Nein	true	-	true, false	Prompt automatisch übersetzen
promptUpsampling	select	Nein	false	-	false, true	Wenn aktiviert, lässt Rivya das Modell deinen Prompt vor der Generierung erweitern und polieren. Das hilft oft der Detailqualität, kann das Ergebnis aber auch interpretativer machen als deinen Rohprompt.
safetyTolerance	number	Nein	2	min 0 / max 6	-	Steuert, wie streng die Inhaltsmoderation ist. Generierung erlaubt normalerweise einen größeren Bereich als Bearbeitung; niedrigere Werte sind strenger und höhere Werte sind permissiver.
watermark	text	Nein	-	-	-	Watermark

Upload-Richtlinie

Lade zuerst Referenzdateien hoch und setze dann die zurückgegebene URL und den durationToken in params.referenceMediaItems.

Referenzregel

Referenzbild: Lade bis zu 1 Bilddatei für Bildbearbeitungsprojekte hoch.

Max. Dateien

Akzeptierte Dateitypen

image

Duration Token

Video- und Audioreferenzen sollten durationToken aus /api/v1/files mitführen, wenn eine Dauerprüfung erforderlich ist.

kind	Max. Größe	MIME-Typen
image	10 MB	image/jpeg, image/png, image/webp

Minimalrequest

{
  "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": "Optionaler Watermark-Text"
  }
}

Request mit Referenzdatei

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

Create-Response

Der Create-Endpunkt gibt eine öffentliche Task-ID zurück. Frage den Status-Endpunkt ab, bis der Task erfolgreich ist oder fehlschlägt.

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

Häufige Fehler

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Einige Modi benötigen Referenz-Uploads über Files API.

Flux Kontext Pro API-Integration