Gunakan Flux Kontext Max melalui Rivya Public API v1 dengan ID model flux-kontext-max, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APITeks atau URL sedia; mod rujukan menggunakan Files APIImej

ID model API

flux-kontext-max

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

Keupayaan

Imej

Bil

FIXED

Had prompt

Tiada had prompt didokumenkan

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	flux-kontext-max	Gunakan ID model API flux-kontext-max.
prompt	string	Ya	-	Teks prompt untuk model yang menyokong input teks.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
aspectRatio	select	Tidak	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Nisbah aspek
outputFormat	select	Tidak	jpeg	-	jpeg, png	JPEG lebih kecil, manakala PNG lebih baik untuk ketelusan atau tepi tanpa kehilangan yang lebih bersih.
enableTranslation	select	Tidak	true	-	true, false	Terjemah prompt secara automatik
promptUpsampling	select	Tidak	false	-	false, true	Apabila diaktifkan, Rivya membenarkan model mengembangkan dan menggilap prompt anda sebelum penjanaan. Ini sering membantu kualiti perincian, tetapi juga boleh menjadikan hasil lebih interpretif berbanding prompt mentah anda.
safetyTolerance	number	Tidak	2	min 0 / max 6	-	Mengawal tahap ketat moderasi kandungan. Penjanaan biasanya membenarkan julat lebih luas berbanding penyuntingan; nilai lebih rendah lebih ketat dan nilai lebih tinggi lebih longgar.
watermark	text	Tidak	-	-	-	Tera air

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Imej rujukan: Muat naik sehingga 1 fail imej untuk projek penyuntingan imej.

Fail maksimum

Jenis fail diterima

image

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis MIME
image	10 MB	image/jpeg, image/png, image/webp

Permintaan minimum

{
  "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": "Teks tera air pilihan"
  }
}

Permintaan fail rujukan

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

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Poll endpoint status sehingga tugasan berjaya atau gagal.

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

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Flux Kontext Max