Google

Imagen 4

imagen-4.0-ultra

Série de génération d'images à partir de texte de Google, mettant l'accent sur le rendu du texte dans l'image et les éclairages complexes, avec trois niveaux Fast, Standard et Ultra selon le compromis entre qualité et coût

imagen-4.0 imagen-4.0-fast imagen-4.0-ultra

Essayer imagen-4.0-ultra

Entrée

Créations

Voir toutes les créations

Sortie

image

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

imagen-4.0-ultra per image

Prix unitaire	$0.090

Présentation et positionnement

imagen-4.0-ultra est le modèle texte-vers-image de la famille Imagen 4 orienté vers une sortie haute fidélité, adapté aux tâches de génération nécessitant un respect précis des prompts, une composition de scènes complexes et un texte lisible dans l'image. Les développeurs génèrent des images à partir de prompts textuels via l'interface unifiée de HiAPI.ai, avec un rapport d'image optionnel de 1:1, 16:9, 9:16, 3:4, 4:3 ou auto ; c'est le choix retenu pour l'étape de production finale de visuels de marque, de maquettes de design et d'images conceptuelles.

Points clés

Respect des prompts et détails plus nets — en tant que version Ultra, l'alignement sur le prompt textuel est renforcé et la sortie colle davantage à la description des instructions, ce qui le destine à la génération d'images de qualité finale.
Rendu du texte dans l'image amélioré — nette progression par rapport à la génération précédente sur le texte intégré à l'image ; les contenus de type affiche ou enseigne deviennent plus exploitables.
Génération directe selon le rapport d'image — le paramètre obligatoire aspect_ratio accepte 1:1, 16:9, 9:16, 3:4, 4:3 et auto, sans recadrage secondaire pour s'adapter aux emplacements de diffusion.

Description des capacités

Génération texte-vers-image haute fidélité : produit des images de style réaliste à partir de prompts textuels, adaptées à une sortie de niveau professionnel pour la marque et le design ; les prompts ont une longueur maximale, l'intention complète doit donc être exprimée dans un nombre de caractères limité.

Composition complexe et rendu de l'éclairage : prend en charge les besoins de composition de scènes complexes et d'éclairage complexe, réduisant les tentatives multiples pour consacrer un seul appel à la production d'une image exploitable.

Contrôle du rapport d'image : le rapport de sortie est spécifié via aspect_ratio obligatoire, couvrant carré, paysage, portrait ainsi que les formats 3:4 et 4:3, pour s'adapter aux spécifications des supports de différents canaux.

Contrainte par prompt négatif : le paramètre facultatif negative_prompt décrit les éléments à éviter, afin de cadrer le contenu de l'image et de réduire la probabilité d'apparition d'éléments non désirés.

Génération reproductible : le paramètre facultatif seed permet une génération reproductible, utile pour figer les résultats lors du débogage et de la production en lot, et comparer l'effet de différents prompts.

Cas d'usage

Équipes de marque et marketing : argumentaires produits — saisir le positionnement de la marque et la description des atouts pour générer des visuels haute fidélité directement utilisables en publicité et sur les canaux sociaux.
Équipes design : besoins de texte pour affiches et présentations — saisir une description de mise en page contenant un titre pour produire une première version au texte relativement net dans l'image, servant de référence et de base d'itération pour affiches et supports de présentation.
Design conceptuel : descriptions de composition et d'éclairage complexes — saisir les exigences de scène, de cadrage et d'éclairage pour générer des images conceptuelles haute fidélité, destinées à la définition visuelle initiale et à la présentation de projets.
Équipes de développement : pipelines de génération en lot — appeler en lot avec un seed et des paramètres de ratio fixes pour produire des images finales au style homogène, à intégrer dans les processus de production de contenu ou de gestion de ressources.

Limites et conseils de sélection

Seule une entrée textuelle est acceptée ; l'édition à partir d'une image d'entrée n'est pas prise en charge. La longueur des prompts est bornée par le schéma, les descriptions trop longues doivent être condensées. Le texte dans l'image, bien qu'amélioré, doit encore être vérifié manuellement avant diffusion. Le coût par image de la version Ultra est supérieur à celui des autres versions de la même famille ; pour de grands volumes de premières versions, il est conseillé de présélectionner avec la version standard ou Fast, puis de produire les images finales avec ce modèle ; pour les besoins d'édition d'image ou d'image-vers-image, il faut choisir un autre modèle.

Nouveautés

Voir le journal des modifications →

Changement de fonctionnalité Les ID des modèles Imagen 4 deviennent imagen-4.0… Oct 21, 2026
Nouveau modèle Ajout de la documentation de génération d'images Google Imagen 4 Oct 14, 2026

Questions fréquentes

Voir toutes les questions →

À quoi sert Imagen 4 ?

Il est adapté aux visuels quotidiens de produits, de mode de vie et de contenu. En précisant clairement le sujet, la scène, les matériaux et la lumière, vous obtenez des images prêtes à être soumises à évaluation, souvent utilisées pour les visuels principaux de produits, les ébauches de campagnes de marque et les illustrations d'articles.
Quels formats d'image Imagen 4 prend-il en charge ?

6 formats sont pris en charge : 1:1, 16:9, 9:16, 3:4, 4:3 et auto. aspect_ratio est obligatoire ; sur cette page, le Playground utilise 16:9 par défaut.
Quelle est la longueur maximale d'un prompt ?

5 000 caractères maximum. Le prompt est obligatoire ; il est recommandé de l'organiser dans l'ordre suivant : sujet, scène, matière, lumière, texte.
Peut-on exclure des éléments non désirés ?

Oui, en utilisant negative_prompt. C'est un paramètre facultatif, d'une longueur maximale de 5 000 caractères, adapté pour exclure du texte superflu, des filigranes ou un arrière-plan encombré.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : imagen-4.0-ultra

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour imagen-4.0-ultra et la route default — voir le tableau des paramètres ci-dessous.

seedstringOptionnelmaxLength 500

Graine aléatoire facultative, sous forme de chaîne de caractères ; fournir la même seed permet de reproduire le résultat de génération avec les mêmes entrées.

promptstringRequisminLength 1maxLength 5000

Description textuelle de l'image à générer, sous forme de chaîne de caractères, servant à spécifier le contenu de la scène.

aspect_ratiostringRequis

Rapport largeur/hauteur de l'image de sortie, sous forme de chaîne de caractères, obligatoire.

Options：1:116:99:163:44:3auto

negative_promptstringOptionnelmaxLength 5000

Prompt négatif facultatif, sous forme de chaîne de caractères, servant à décrire les éléments que l'on souhaite éviter dans l'image générée.

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imagen-4.0-ultra",
  "input": {
    "prompt": "…",
    "aspect_ratio": "…"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "imagen-4.0-ultra",
    input: {
      "prompt": "…",
      "aspect_ratio": "…"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "imagen-4.0-ultra",
        "input": {
          "prompt": "…",
          "aspect_ratio": "…"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}