Utilisez 4o Image via Rivya Public API v1 avec le model id 4o-image, 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 APIEntrée texte prêteImage

ID de modèle API

4o-image

Entrées

text

Files API

Non requis pour la requête minimale

Crédits de base

Tarif en crédits: 3 / requête Le coût final de la tâche est arrondi au crédit entier supérieur.

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	4o-image	Utilisez 4o-image 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
size	select	Non	1:1	-	1:1, 3:2, 2:3	Ratio d'aspect

Requête minimale

{
  "model": "4o-image",
  "prompt": "Un flacon de produit sur un fond gris clair, éclairé doucement depuis la gauche.",
  "params": {
    "size": "1:1"
  }
}

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_4o_image_example",
  "status": "queued",
  "model": "4o-image",
  "reserved_credits": 3,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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