Utilisez Flux Kontext Pro via Rivya Public API v1 avec le model id flux-kontext-pro, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APITexte ou URL prêt ; les modes de référence utilisent Files APIImage

ID de modèle API

flux-kontext-pro

Entrées

text, file

Files API

Requis pour les modes avec référence

Crédits de base

Capacité

Image

Facturation

FIXED

Limite de prompt

Aucune limite de prompt documentée

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	flux-kontext-pro	Utilisez flux-kontext-pro comme ID de modèle API.
prompt	string	Oui	-	Texte de prompt pour les modèles qui prennent en charge l'entrée texte.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
aspectRatio	select	Non	16:9	-	21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Format d'image
outputFormat	select	Non	jpeg	-	jpeg, png	JPEG est plus léger, tandis que PNG convient mieux à la transparence ou aux bords sans perte plus nets.
enableTranslation	select	Non	true	-	true, false	Traduire automatiquement le prompt
promptUpsampling	select	Non	false	-	false, true	Quand cette option est activée, Rivya laisse le modèle développer et peaufiner votre prompt avant la génération. Cela aide souvent la qualité des détails, mais peut aussi rendre le résultat plus interprétatif que votre prompt brut.
safetyTolerance	number	Non	2	min 0 / max 6	-	Contrôle le niveau de stricteté de la modération du contenu. La génération autorise généralement une plage plus large que l'édition ; les valeurs basses sont plus strictes et les valeurs hautes plus permissives.
watermark	text	Non	-	-	-	Filigrane

Règle d'importation

Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.

Règle de référence

Image de référence: Importez jusqu'à 1 fichier image pour les projets d'édition d'image.

Nombre max. de fichiers

Types de fichier acceptés

image

Duration token

Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.

kind	Taille max.	Types MIME
image	10 MB	image/jpeg, image/png, image/webp

Requête minimale

{
  "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": "Texte de filigrane optionnel"
  }
}

Requête avec fichier de référence

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

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

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

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Certains modes exigent des importations de référence via Files API.

Intégration API Flux Kontext Pro