Imagen 4
imagen-4.0
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
Essayer imagen-4.0
Entrée
Créations
Voir toutes les créationsSortie
imageTarifs
imagen-4.0 per image
| Prix unitaire | $0.060 |
|---|
Présentation
imagen-4.0 est le modèle texte-image standard de la série Imagen 4. Il n'accepte que des invites textuelles et convient aux besoins de génération quotidiens qui cherchent un équilibre entre qualité d'image et coût de génération. Il prend en charge des invites allant jusqu'à 5000 caractères et une invite négative allant jusqu'à 500 caractères, permet de spécifier un format parmi 1:1, 16:9, 9:16, 3:4, 4:3 et auto, et utilise seed pour rendre une même configuration reproductible. Comparé à la version rapide, il est plus adapté à la génération par lots exigeant une qualité de rendu stable, sans rechercher les détails extrêmes ; les développeurs peuvent l'intégrer à leur propre flux de génération en l'appelant via l'interface unifiée de HiAPI.ai.
Points clés
- Améliorations spécifiques du rendu de texte dans l'image — les études montrent que cette série progresse nettement par rapport à la génération précédente sur la génération de texte dans l'image, ce qui convient aux maquettes nécessitant d'afficher du texte lisible.
- Prise en charge de l'invite négative et de la reproduction via seed — negative_prompt permet d'exclure les éléments non souhaités, et seed de reproduire à l'identique une même configuration de génération, ce qui facilite les itérations et les validations de régression.
- Six formats directement spécifiables — aspect_ratio couvre le carré, le paysage, le portrait ainsi que 3:4 et 4:3, avec en plus une option auto pour une sélection automatique, sans recadrage ultérieur.
- Positionnement clair du niveau standard — la même série propose également les niveaux Fast et Ultra ; la version standard constitue le choix par défaut pour la génération par lots au quotidien, à faire évoluer en cas d'exigences de rendu final plus élevées.
Description des capacités
Génération d'images à partir de texte : il suffit de saisir une description textuelle pour obtenir une image ; l'invite est limitée à 5000 caractères, ce qui suffit à décrire assez complètement le sujet, le style et la composition.
Paramètres de contrôle de génération : negative_prompt sert à déclarer les éléments à exclure, seed à reproduire un même résultat ; leur combinaison rend le processus de génération ajustable et traçable.
Adaptation du format : le ratio de sortie peut être choisi entre carré, paysage, portrait, 4:3 et 3:4, ou confié à auto, qui détermine le ratio de composition selon le contenu de l'invite.
Présentation de texte lisible : lorsque le contenu textuel de l'image est décrit dans l'invite, le modèle traite mieux le rendu du texte que la génération précédente, mais une vérification humaine des glyphes finaux reste nécessaire.
Cas d'usage
- Visuels pour les réseaux sociaux des équipes marketing — décrire la scène en texte selon le thème de la campagne, choisir un ratio paysage ou portrait pour produire des visuels en série et les publier directement sur les canaux de contenu.
- Affiches et esquisses de présentation pour les designers — générer avec une invite contenant le texte du titre une première version d'affiche ou de couverture avec du texte, comme référence de direction visuelle avant la mise en page.
- Images de concept produit à style fixe — fixer seed et format, affiner l'invite de façon répétée autour d'un même produit pour produire des images de concept au style cohérent destinées à l'évaluation des propositions.
- Intégration automatisée dans un flux de génération — utiliser la génération texte-image comme une étape du pipeline, avec des invites et des paramètres de ratio transmis par programme, pour produire des ressources en série et les faire passer à la validation en aval.
Limites et conseils de choix
L'entrée est uniquement textuelle et ne permet pas l'édition ou la retouche locale à partir d'une image existante ; les paramètres se limitent à l'invite, l'invite négative, le format et seed, sans contrôles plus fins comme le nombre d'étapes ou l'intensité du style. Bien que le texte dans l'image soit amélioré par rapport à la génération précédente, il est recommandé de le vérifier image par image avant livraison. Pour une meilleure fidélité à l'invite et un rendu des détails plus poussé, on peut envisager le niveau Ultra de la même série ; pour privilégier la vitesse de génération, choisir le niveau Fast. Ce modèle ne convient pas aux scénarios nécessitant une entrée image ou un contrôle local précis.
Nouveautés
Voir le journal des modifications →- Changement de fonctionnalité Les ID des modèles Imagen 4 deviennent imagen-4.0…
- Nouveau modèle Ajout de la documentation de génération d'images Google Imagen 4
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
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe 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-KeystringOptionnelClé 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.
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
modelstringRequisValeur fixe actuelle : imagen-4.0
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour imagen-4.0 et la route default — voir le tableau des paramètres ci-dessous.
seedstringOptionnelmaxLength 500Graine aléatoire facultative, utilisée pour la reproductibilité des résultats générés ; à transmettre sous forme de chaîne de caractères.
promptstringRequisminLength 1maxLength 5000Description textuelle de l'image à générer, principale entrée de la génération d'image.
aspect_ratiostringRequisContrôle le rapport largeur-hauteur de l'image de sortie, à spécifier sous forme de chaîne de caractères.
1:116:99:163:44:3autonegative_promptstringOptionnelmaxLength 5000Décrit les éléments à exclure de l'image générée, à transmettre sous forme de texte.
callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
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.
urlstringRequisObligatoire 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.
finalstoragestringOptionnelDé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.
temppersistentExemples 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",
"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",
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",
"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
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom 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.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
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.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes 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
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription 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"
}
}
} Articles
Voir tous les articles →-
Tutoriel
recraft-v4.1-flash génération d'images texte-à-image en pratique : 5 scénarios métier à forte valeur et points d'intégration clés
À partir d'un coût de 0,01 $ par image, planifier le déploiement de la génération d'images dans de vrais contextes métier
-
Comparatif et évaluation
Comparatif horizontal de Recraft v4.1 Flash en génération d'images à partir de texte : guide de sélection et de migration pour les développeurs
Avec un coût de 0,01 $ par image et ses capacités de génération pure à partir de texte, déterminez s'il convient à votre pipeline de génération d'images
-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
-
Comparatif et évaluation
Comparatif transversal de hailuo-2.3-fast/image-to-video : comment choisir un modèle image-to-video et les points clés de migration
-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
Modèles associés
Voir tous les modèles →Même type
-
Grok Imagine Image 2.0 xAI $0.052 /image -
FASHN Tryon v1.6 FASHN $0.107 /image -
Seedream 5.0 ByteDance $0.025 /image -
Ideogram V4 Ideogram $0.050 /image -
Qwen Image 3.0 Alibaba $0.036 /image -
Nano Banana 2 Google $0.036 /image -
FLUX.1 Kontext Max Black Forest Labs $0.071 /image -
Krea 2 Medium Turbo Krea $0.021 /image -
Recraft Crisp Upscale Recraft $0.004 /image -
Z-Image Alibaba $0.008 /image -
FLUX.2 Black Forest Labs $0.035 /image -
GPT Image 2 OpenAI $0.007 /image
Même fournisseur
-
Gemini Omni Google -- -
Google Virtual Try-On Google $0.107 /image -
Veo 3.1 Google $0.290 /seconde -
Gemini Omni 1.1 Flash Google $0.450 /vidéo -
Lyria 3 Pro Google $0.140 /morceau -
Lyria 3.5 Google $0.090 /morceau -
Nano Banana Google $0.021 /image -
Veo 3.1 Fast Google $0.170 /seconde -
Nano Banana 2 Lite Google $0.033 /image -
Nano Banana Pro Google $0.057 /image -
Gemini 3.1 Flash TTS Google -- -
Nano Banana 2 Google $0.036 /image



