Flux Kontext Pro modelini Rivya Public API v1 üzerinden model id flux-kontext-pro, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin veya URL hazır; referans modları Files API kullanırGörsel

API model id

flux-kontext-pro

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

Yetenek

Görsel

Faturalandırma

FIXED

Prompt limiti

Belgelenmiş prompt limiti yok

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	flux-kontext-pro	flux-kontext-pro API model id değerini kullanın.
prompt	string	Evet	-	Metin girişini destekleyen modeller için prompt metni.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
aspectRatio	select	Hayır	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	En boy oranı
outputFormat	select	Hayır	jpeg	-	jpeg, png	JPEG daha küçüktür; PNG ise şeffaflık veya daha temiz kayıpsız kenarlar için daha uygundur.
enableTranslation	select	Hayır	true	-	true, false	İstemi otomatik çevir
promptUpsampling	select	Hayır	false	-	false, true	Etkinleştirildiğinde Rivya, üretimden önce modelin isteminizi genişletmesine ve cilalamasına izin verir. Genellikle ayrıntı kalitesine yardımcı olur, ancak sonucu ham isteminizden daha yorumlayıcı da yapabilir.
safetyTolerance	number	Hayır	2	min 0 / max 6	-	İçerik moderasyonunun ne kadar sıkı olduğunu kontrol eder. Üretim genellikle düzenlemeye göre daha geniş bir aralığa izin verir; düşük değerler daha sıkı, yüksek değerler daha izin vericidir.
watermark	text	Hayır	-	-	-	Filigran

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Referans görsel: Görsel düzenleme projeleri için 1 adede kadar görsel dosyası yükleyin.

Maks. dosya

Kabul edilen dosya türleri

image

Duration token

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
image	10 MB	image/jpeg, image/png, image/webp

Minimal istek

{
  "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": "İsteğe bağlı filigran metni"
  }
}

Referans dosyalı istek

{
  "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": "İsteğe bağlı filigran metni",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

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

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Flux Kontext Pro API Entegrasyonu