Pages API par modèle
Intégration API Google Imagen4 Ultra
Utilisez Google Imagen4 Ultra via Rivya Public API v1 avec le model id google-imagen4-ultra, 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
google-imagen4-ultra
Entrées
text
Files API
Non requis pour la requête minimale
Crédits de base
12
Capacité
Image
Facturation
FIXED
Limite de prompt
5000 caractères
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 | google-imagen4-ultra | Utilisez google-imagen4-ultra comme ID de modèle API. |
| prompt | string | Oui | - | Maximum 5000 caractères pour ce modèle. |
| 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 |
|---|---|---|---|---|---|---|
| aspect_ratio | select | Non | 1:1 | - | 1:1, 16:9, 9:16, 3:4, 4:3 | Format d'image |
| negative_prompt | text | Non | - | - | - | Prompt négatif |
| seed | text | Non | - | - | - | Laissez ce champ vide pour obtenir un nouveau résultat aléatoire à chaque fois. Réutiliser le même entier facilite la reproduction ou l'ajustement fin d'un résultat précédent. Le résultat reste plus proche uniquement si le prompt et les autres réglages clés restent eux aussi similaires, et cela ne garantit pas une correspondance 1:1. |
Requête minimale
{
"model": "google-imagen4-ultra",
"prompt": "A clean editorial product image on a soft studio background",
"params": {
"aspect_ratio": "1:1",
"negative_prompt": "Éléments optionnels à éviter",
"seed": "Valeur de graine optionnelle"
}
}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_google_imagen4_ultra_example",
"status": "queued",
"model": "google-imagen4-ultra",
"reserved_credits": 12,
"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
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.