Käytä mallia Flux Kontext Pro Rivya Public API v1:n kautta malli-ID:llä flux-kontext-pro; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaTeksti tai URL valmis; referenssimoodit käyttävät Files API:aKuva

API-malli-ID

flux-kontext-pro

Syötteet

text, file

Files API

Vaaditaan referenssimoodeissa

Peruskrediitit

Kyvykkyys

Kuva

Laskutus

FIXED

Prompt-raja

Dokumentoitu prompt-raja puuttuu

Pyyntösopimus

Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.

Avain	Tyyppi	Pakollinen	Oletus	Kuvaus
model	string	Kyllä	flux-kontext-pro	Käytä flux-kontext-pro-arvoa API-malli-ID:nä.
prompt	string	Kyllä	-	Prompt-teksti malleille, jotka tukevat tekstisyötettä.
params	object	Ei	-	Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin.
client_request_id	string	Ei	-	Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

Avain	Tyyppi	Pakollinen	Oletus	Alue	Vaihtoehdot	Kuvaus
aspectRatio	select	Ei	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Kuvasuhde
outputFormat	select	Ei	jpeg	-	jpeg, png	JPEG on pienempi, kun taas PNG sopii paremmin läpinäkyvyyteen tai siistimpiin häviöttömiin reunoihin.
enableTranslation	select	Ei	true	-	true, false	Käännä prompti automaattisesti
promptUpsampling	select	Ei	false	-	false, true	Kun asetus on käytössä, Rivya antaa mallin laajentaa ja viimeistellä promptisi ennen generointia. Se auttaa usein yksityiskohtien laadussa, mutta voi myös tehdä tuloksesta tulkitsevamman kuin raaka promptisi.
safetyTolerance	number	Ei	2	min 0 / max 6	-	Säätää, kuinka tiukka sisällön moderointi on. Generointi sallii yleensä laajemman vaihtelun kuin editointi; pienemmät arvot ovat tiukempia ja suuremmat sallivampia.
watermark	text	Ei	-	-	-	Vesileima

Latauskäytäntö

Lataa referenssitiedostot ensin ja sijoita sitten palautettu URL ja duration token params.referenceMediaItems-arvon sisään.

Referenssisääntö

Referenssikuva: Lataa enintään 1 kuvatiedosto kuvaeditointiprojekteja varten.

Enimmäistiedostot

Hyväksytyt tiedostotyypit

image

Duration token

Video- ja äänireferenssien pitäisi kantaa /api/v1/files-reitin durationToken-arvoa, kun keston varmennus vaaditaan.

kind	Enimmäiskoko	MIME-tyypit
image	10 MB	image/jpeg, image/png, image/webp

Minimipyyntö

{
  "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": "Valinnainen vesileimateksti"
  }
}

Referenssitiedostopyyntö

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

Create-vastaus

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.

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

Yleiset virheet

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Jotkin moodit vaativat Files API -referenssilatauksia.

Flux Kontext Pro API -integraatio