Usa Flux Kontext Max tramite Rivya Public API v1 con model id flux-kontext-max, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APITesto o URL pronti; le modalità di riferimento usano Files APIImmagine

ID modello API

flux-kontext-max

Input

text, file

Files API

Richiesto per le modalità con riferimento

Crediti base

Capacità

Immagine

Fatturazione

FIXED

Limite prompt

Nessun limite prompt documentato

Contratto della richiesta

Invia l'ID modello al livello superiore. I controlli specifici del modello vanno in params.

Key	Tipo	Obbligatorio	Predefinito	Descrizione
model	string	Sì	flux-kontext-max	Usa flux-kontext-max come ID modello API.
prompt	string	Sì	-	Testo del prompt per i modelli che supportano input testuale.
params	object	No	-	Oggetto parametri specifico del modello. Usa le righe sotto per le key consentite.
client_request_id	string	No	-	ID client facoltativo per tracciare le richieste nel tuo sistema.

Parametri del modello

Key	Tipo	Obbligatorio	Predefinito	Intervallo	Opzioni	Descrizione
aspectRatio	select	No	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Rapporto d'aspetto
outputFormat	select	No	jpeg	-	jpeg, png	JPEG è più leggero, mentre PNG è migliore per trasparenza o bordi senza perdita più puliti.
enableTranslation	select	No	true	-	true, false	Traduci automaticamente il prompt
promptUpsampling	select	No	false	-	false, true	Quando è attivo, Rivya lascia che il modello espanda e rifinisca il prompt prima della generazione. Spesso aiuta la qualità dei dettagli, ma può anche rendere il risultato più interpretativo rispetto al prompt grezzo.
safetyTolerance	number	No	2	min 0 / max 6	-	Controlla quanto è rigorosa la moderazione dei contenuti. La generazione di solito consente un intervallo più ampio dell'editing; valori più bassi sono più severi e valori più alti sono più permissivi.
watermark	text	No	-	-	-	Filigrana

Regola di upload

Carica prima i file di riferimento, poi inserisci l'URL restituito e il durationToken dentro params.referenceMediaItems.

Regola di riferimento

Immagine di riferimento: Carica fino a 1 file immagine per progetti di editing immagini.

File massimi

Tipi di file accettati

image

Duration token

I riferimenti video e audio devono includere durationToken da /api/v1/files quando è richiesta la verifica della durata.

kind	Dimensione massima	Tipi MIME
image	10 MB	image/jpeg, image/png, image/webp

Richiesta minima

{
  "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": "Testo filigrana opzionale"
  }
}

Richiesta con file di riferimento

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

Risposta di creazione

L'endpoint di creazione restituisce un ID task pubblico. Interroga l'endpoint di stato finché il task riesce o fallisce.

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

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Alcune modalità richiedono upload di riferimento tramite Files API.

Integrazione API di Flux Kontext Max