Ideogram
Ideogram V4
ideogram-v4
Modèle texte-image à poids ouverts, spécialisé dans le rendu de texte multilingue et la sortie native 2K, avec prise en charge des prompts JSON et du contrôle de mise en page par boîtes englobantes
Essayer ideogram-v4
Entrée
Créations
Voir toutes les créationsSortie
Tarifs
ideogram-v4 per image
| Spécifications | Prix unitaire |
|---|---|
| TURBO | $0.050 |
| BALANCED | $0.100 |
| QUALITY | $0.170 |
Présentation
ideogram-v4 est le modèle de génération d'images à partir de texte d'Ideogram, réputé pour la précision de la typographie qu'il intègre à l'image. Il convient aux développeurs qui doivent rendre directement des textes lisibles et des messages multilingues dans des supports tels que des affiches ou des publicités. Appelable via l'interface unifiée de HiAPI.ai, il suffit de fournir une invite en langage naturel et un niveau de vitesse de rendu pour obtenir une image, avec prise en charge de plusieurs ratios d'image, d'une sortie JPEG/PNG et de la reproductibilité par graine fixe. La structure des paramètres est simple, ce qui facilite la production en série et l'intégration.
Points clés
- Le rendu typographique dans l'image est son axe d'optimisation principal : le texte indiqué dans l'invite peut être directement rendu comme contenu de l'image, ce qui permet de réaliser la mise en page dès la génération plutôt que par une superposition ultérieure.
- Trois niveaux de vitesse de rendu commutables à la demande : TURBO, BALANCED et QUALITY correspondent à différents compromis entre rapidité et souci du détail, ce qui permet de répartir les appels entre brouillons en série et images de haute qualité.
- Graine et ratio d'image contrôlables, pour la reproductibilité et l'adaptation : prise en charge d'une graine fixe pour reproduire un résultat, avec cinq ratios 1:1, 16:9, 4:3, 9:16 et 3:4 couvrant les besoins de mise en page courants.
Capacités
Génération directe d'images contenant du texte à partir d'une invite : en saisissant une invite descriptive et en précisant le texte à afficher, on obtient une image finale mise en page, ce qui réduit l'étape de superposition de texte en post-traitement.
Réglage de la vitesse de rendu par paliers : via rendering_speed, on choisit entre TURBO, BALANCED et QUALITY pour arbitrer entre vitesse et détail selon l'usage.
Ratio d'image et format de sortie au choix : les ratios de sortie couvrent le carré, le paysage et le portrait, et les formats JPEG et PNG sont pris en charge, pour s'adapter directement aux emplacements de diffusion ou à un traitement ultérieur.
Reproductibilité des résultats par graine fixe : en spécifiant seed, on peut reproduire un même résultat avec les mêmes paramètres, ce qui facilite la comparaison des effets d'un ajustement d'invite ou la stabilité d'une production en série.
Cas d'usage
- Génération en série d'ébauches d'affiches contenant du texte par les équipes de design : en saisissant le texte et la description de mise en page, un seul appel produit une image complète mise en page, pour la présélection de concepts et la validation des directions créatives.
- Création de supports multilingues par les équipes marketing : en intégrant le texte dans la langue cible à l'invite, on génère des images marketing directement utilisables pour la diffusion ou une retouche ultérieure.
- Intégration d'une interface de génération d'images à la demande par les développeurs : via l'interface unifiée, générer à la demande des images au ratio et au format spécifiés, et les intégrer à un flux de travail de contenu ou à une chaîne de production automatisée de supports.
Limites et conseils de choix
Ce modèle couvre uniquement la génération d'images à partir de texte et ne dispose pas de capacités d'édition d'image ni d'image vers image ; pour modifier une image ou repeindre une zone, il faut choisir un autre modèle. La longueur maximale de l'invite est généreuse, mais le contrôle de la mise en page repose encore sur la description textuelle, et les mises en page complexes nécessitent des ajustements répétés. Le niveau de vitesse de rendu influe sur le détail et la durée de génération ; pour les scénarios en série, il est conseillé de valider d'abord le résultat avec un niveau bas. Le texte à afficher dans l'image doit être entièrement précisé dans l'invite, car une description floue peut entraîner des écarts de rendu.
Questions fréquentes
Voir toutes les questions →-
À quoi Ideogram V4 est-il le plus adapté ?
Aux logos, affiches, lettrages, packagings et enseignes de boutique nécessitant un rendu précis des lettres latines.
-
Comment choisir parmi les trois niveaux de vitesse ?
TURBO convient aux brouillons rapides ; BALANCED équilibre vitesse et qualité ; QUALITY convient aux détails finaux et aux enseignes complexes.
-
Comment les trois niveaux de prix se distinguent-ils ?
TURBO, BALANCED et QUALITY utilisent des tarifs unitaires différents ; les montants exacts sont ceux affichés en temps réel sur cette page.
-
Comment améliorer la précision du texte dans une image ?
Écrivez mot pour mot dans le Prompt le texte à afficher, et précisez le style de police, la hiérarchie, la position et le contraste avec l'arrière-plan.
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 : ideogram-v4
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour ideogram-v4 et la route default — voir le tableau des paramètres ci-dessous.
seedintegerOptionnelGraine aléatoire pour une génération reproductible : avec la même graine et les mêmes paramètres, on obtient des résultats identiques ; si elle n'est pas fournie, le serveur en choisit une au hasard.
promptstringRequisminLength 1maxLength 10000Description textuelle du contenu de l'image. Le texte à rendre doit être explicitement orthographié ici ; une mise en page précise est la spécialité de ce modèle.
aspect_ratiostringOptionnelDéfaut: "1:1"Rapport largeur-hauteur de l'image de sortie, correspondant à une taille prédéfinie d'environ 1 MP ; par défaut 1:1.
1:116:94:39:163:4output_formatstringOptionnelDéfaut: "jpeg"Format de l'image de sortie ; par défaut jpeg.
jpegpngrendering_speedstringRequisDéfaut: "BALANCED"Niveau de vitesse de rendu : TURBO est le plus rapide et le moins cher, QUALITY offre le plus de détails, et les tarifs varient selon le niveau ; par défaut BALANCED.
TURBOBALANCEDQUALITYcallbackobjectOptionnel
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": "ideogram-v4",
"input": {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "jpeg",
"rendering_speed": "BALANCED"
}
}' 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: "ideogram-v4",
input: {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "jpeg",
"rendering_speed": "BALANCED"
}
}),
});
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": "ideogram-v4",
"input": {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "jpeg",
"rendering_speed": "BALANCED"
}
},
)
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
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
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
-
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
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
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
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
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
-
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
-
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
Modèles associés
Voir tous les modèles →Même type
-
Nano Banana Pro Google $0.057 /image -
BRIA Eraser Bria $0.058 /image -
Recraft V4.1 Recraft $0.010 /image -
Seedream 4.5 ByteDance $0.045 /image -
FLUX 1.1 Pro Black Forest Labs $0.050 /image -
Grok Imagine Image 2.0 xAI $0.052 /image -
Ideogram V3 Character Ideogram $0.090 /image -
Recraft Crisp Upscale Recraft $0.004 /image -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /image -
BRIA Product Shot Bria $0.058 /image -
Krea 2 Medium Turbo Krea $0.021 /image -
Krea 3 Krea $0.036 /image



