Guide d'utilisation
Recettes de prompts Ideogram v4.5 : prompts typographiques prêts à copier-coller et sorties réelles
La plupart des modèles d'image savent dessiner une belle affiche, mais écrivent mal le titre. Toute la réputation d'Ideogram repose sur le contraire : il sait écrire correctement les lettres. ideogram-v4.5/text-to-image est le dernier modèle texte-vers-image d'Ideogram sur hiapi, et comme tous les autres modèles, il s'exécute sur l'API task unifiée. Cette page est une bibliothèque de prompts directement utilisable — six recettes couvrant logos, affiches, bannières et packaging, chacune accompagnée du prompt que j'ai réellement envoyé et de l'image réellement renvoyée. Chaque sortie ci-dessous a été générée avec ideogram-v4.5/text-to-image sur hiapi ; aucune n'est une image de stock, et aucune n'a été retouchée.
Elle répond aussi à une question que ces recettes soulèvent sans cesse : le niveau quality. v4.5 facture selon trois niveaux — low, medium, high — avec des écarts de prix considérables, j'ai donc lancé le même prompt et la même graine sur les trois niveaux, puis comparé le rendu réel du texte. Le résultat ne correspond pas à ce que vous imaginez ; voir la section sur les niveaux de qualité ci-dessous.
Portée : il s'agit ici du point de terminaison texte-vers-image de base. v4.5 dispose aussi d'une route distincte image-vers-image/édition (
ideogram-v4.5/image-to-image) avec masques et images de référence — c'est un autre schéma, qui fera l'objet d'un autre article.
Le schéma réellement accepté par v4.5 (moins de champs que vous ne le pensez)
Avant les recettes, parlons du contrat d'entrée — car la surface d'API de v4.5 n'est pas la même que celle d'ideogram-v4. J'ai sondé l'API en production champ par champ. Il n'en faut que cinq :
| Champ | Type | Description |
|---|---|---|
prompt |
string, obligatoire | Placez le texte à rendre entre guillemets doubles (voir section suivante). |
quality |
low / medium / high |
Niveau de prix. Le comportement par défaut équivaut à medium. |
num_images |
entier 1–8 | Une tâche peut renvoyer tout un lot d'images. |
seed |
entier | Fixez-le pour comparer équitablement deux prompts (ou deux niveaux). |
image_size |
énumération | L'une des valeurs : square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. |
Ce qui m'a surpris : il n'y a ni champ aspect_ratio ni champ resolution. v4 accepte une chaîne aspect_ratio et rendering_speed ; v4.5 a supprimé les deux. Vous ne pouvez choisir une forme que parmi six préréglages image_size, c'est le seul contrôle de dimensions — l'API rejette directement aspect_ratio, resolution, rendering_speed, magic_prompt, style_type et negative_prompt avec additional properties not allowed. Donc si vous migrez une requête depuis v4, supprimez ces champs, sinon chaque appel renverra un 400.
Les prix proviennent de la page de tarification en ligne de hiapi, facturés à l'image, et varient selon le niveau :
quality |
Prix par image |
|---|---|
low |
$0.043 |
medium |
$0.086 |
high |
$0.3145 |
Voici la requête minimale — créez la tâche, puis interrogez jusqu'à la fin :
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": "A clean wordmark logo, the text \"NORTHWIND ROASTERS\" in an elegant high-contrast serif, cream background, centered",
"quality": "medium",
"image_size": "square",
"num_images": 1
}
}'
# -> {"data":{"taskId":"tk-..."}}
import os, time, requests
BASE = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
task = requests.post(BASE, headers=H, json={
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": 'A clean wordmark logo, the text "NORTHWIND ROASTERS" '
'in an elegant high-contrast serif, cream background, centered',
"quality": "medium",
"image_size": "square",
"num_images": 1,
},
}).json()
tid = task["data"]["taskId"]
while True: # poll to a terminal state
d = requests.get(f"{BASE}/{tid}", headers=H).json()["data"]
if d["status"] in ("success", "fail"):
break
time.sleep(5)
print(d["output"][0]["url"]) # temp URL — download it right away
output[0].url est un lien temporaire qui expire au bout d'une semaine environ, téléchargez donc les octets immédiatement — ne le référencez pas en dur en production.
La seule règle qui décide du succès de chaque recette
Tout ce qui suit repose sur une habitude : mettez entre guillemets doubles le texte exact que vous voulez voir rendu, ne laissez pas le modèle inventer la copie qui compte pour vous.
Ideogram étend votre prompt. Demandez une affiche de festival de musique, il ajoutera volontiers une programmation, des dates et des prix que vous n'avez jamais écrits — parfait pour une maquette réaliste, mais risqué si ces détails doivent être corrects. Dans mes tests, chaque courte chaîne que j'avais mise entre guillemets était parfaitement orthographiée ; c'est dans le texte inventé par le modèle que surgissent les fautes. Donc : mettez entre guillemets les noms de marque, les titres, le texte des boutons et les dates. Ne laissez le remplissage décoratif au modèle que si cela ne vous dérange pas.
Cette règle acquise, voici les recettes.
Recette 1 — logo wordmark textuel
A clean minimalist wordmark logo for a specialty coffee brand, the text "NORTHWIND ROASTERS" set in an elegant high-contrast serif, a small compass-rose icon integrated above the letter N, warm cream background, centered, flat vector-style design, generous negative space
image_size: square · quality: medium

« NORTHWIND ROASTERS » est parfaitement correct, la police serif est vraiment élégante, et l'espace négatif ressemble à un vrai logo de marque. Deux remarques honnêtes : le modèle a placé la rose des vents au-dessus et au centre du wordmark entier, plutôt que « au-dessus de la lettre N » — v4.5 traite les instructions spatiales comme des suggestions, pas comme des coordonnées — et il a ajouté de lui-même une accroche que je n'avais jamais demandée : « SPECIALTY COFFEE · EST. 2019 ». Cette extension est exactement le comportement décrit par la règle ci-dessus : pratique ici, mais si votre vraie accroche diffère, écrivez-la explicitement entre guillemets au lieu de laisser le modèle deviner.
Recette 2 — affiche d'événement
A vertical concert poster for an indie music festival, large headline text "ECHO VALLEY FEST" across the top, below it two lines reading "AUGUST 14-16" and "RIVERSIDE PARK", retro 1970s psychedelic palette of orange, magenta and teal, layered sunburst background, bold condensed type, high detail
image_size: portrait_4_3 · quality: medium

Les trois chaînes entre guillemets — « ECHO VALLEY FEST », « AUGUST 14-16 », « RIVERSIDE PARK » — sont rendues proprement, et la forme portrait_4_3 laisse respirer le titre. Le modèle a aussi rempli de lui-même une programmation de groupes crédible, ainsi qu'un pied de page « GATES 6PM · ALL AGES · $45 ADV / $60 DOOR ». C'est cadeau pour une maquette de proposition ; pour une affiche réelle, réintroduisez ces lignes inventées dans le prompt afin de les contrôler.
Recette 3 — bannière publicitaire pour réseaux sociaux
A horizontal social media ad banner for a fitness app, left-aligned headline text "MOVE MORE." in heavy bold uppercase, a smaller line reading "Start your 7-day free trial", and a rounded call-to-action button with the text "GET THE APP", energetic gradient from lime green to deep blue, clean modern UI style
image_size: landscape_16_9 · quality: medium

C'est là que v4.5 excelle : trois chaînes courtes distinctes — titre, sous-titre et texte du bouton — toutes placées dans des rôles d'interface différents, et toutes correctement orthographiées, y compris le point dans « MOVE MORE. ». Le préréglage landscape_16_9 est celui à utiliser quand il vous faut une bannière large ou une vignette. Une copie courte, explicite et entre guillemets, c'est exactement ce que ce modèle réussit.
Recette 4 — étiquette de packaging produit
A product label for a bottle of artisanal hot sauce, brand name "EMBER & ASH" in a vintage woodcut serif, product line "SMOKED HABANERO" below it, a small badge reading "SMALL BATCH - 150ML", kraft-paper texture background with charcoal and ember-orange ink, symmetrical layout
image_size: square_hd · quality: medium

Le packaging est le test de texte le plus difficile — petite taille, caractères spéciaux, badges — et v4.5 passe l'essentiel. « EMBER & ASH » rend correctement l'esperluette (un point d'échec classique), « SMOKED HABANERO » est net, et le piment habanero gravé est un joli détail non demandé. Le petit badge a dérivé : j'avais demandé « SMALL BATCH - 150ML » et j'ai obtenu « SMALL BATCH · EST · 150ML » plus une ligne « BOTTLED IN SMALL BATCHES ». La leçon du manuel reste valable — plus la taille de police est petite, plus le modèle improvise, donc pour une étiquette destinée à l'impression, gardez la micro-copie courte et vérifiez chaque rendu un par un.
Les niveaux de qualité à l'épreuve : low vs medium vs high
Ces recettes ont toutes été exécutées en medium. Mais v4.5 facture low / medium / high à $0.043 / $0.086 / $0.3145 — un écart de 7 fois — cela vaut donc la peine de savoir ce que l'argent achète. J'ai lancé un prompt volontairement dense en texte (une affiche infographique dense) sur les trois niveaux, avec la même graine, de sorte que seul quality change :
A dense informational poster titled "CITY TRANSIT GUIDE" with three labeled columns headed "BUS", "METRO" and "TRAM", a short line of body text under each heading, clean Swiss grid layout, red and black ink on off-white paper, flat vector infographic style
low — $0.043

La mise en page et le grand titre « CITY TRANSIT GUIDE » sont nets. Mais le modèle a inventé un sous-titre et l'a mal orthographié — « WINTER SCHHEDULE » avec un H en trop — et a dupliqué un badge de ligne (le « 41 » apparaît deux fois). Les titres entre guillemets (BUS/METRO/TRAM) sont corrects ; c'est dans la copie non citée qu'il a ajoutée que se trouvent les erreurs.
medium — $0.086

Même graine, un cran au-dessus, le sous-titre se corrige de lui-même en « WINTER SCHEDULE ». Les trois blocs de texte sont lisibles, et la navigation de pied de page (« TICKETS · ZONES · DELAYS · HELP ») est propre. Il reste un petit défaut de légende (« CENTRHL » au lieu de « CENTRAL »), mais pour une mise en page aussi dense en texte, c'est clairement la plus propre des trois.
high — $0.3145

Voici la partie contre-intuitive. Les polices d'affichage rendues par high — le grand titre, les libellés BUS/METRO/TRAM — sont les plus nettes des trois. Mais les paragraphes de corps de texte dense s'effondrent en charabia confiant (« Mari routes runt monen downtwing... », « tith tixve stations across five... »). À 3,6 fois le prix de medium, il produit sur cette mise en page un corps de texte pire, pas meilleur.
La conclusion est pratique, pas dépréciative envers le modèle : le niveau quality augmente la finesse avec laquelle v4.5 rend la police qu'il a choisie, mais il ne rend pas le modèle meilleur pour inventer de longs blocs de copie que vous n'avez pas écrits — en high, il ne fait qu'inventer plus finement, et plus faux. Donc :
- Faites de
mediumvotre défaut. C'est le meilleur compromis pour tout ce qui contient du vrai texte, et il corrige les fautes introduites parlow. - Réservez
highaux œuvres surtout composées de grandes polices spécifiées — logos, affiches à titre sur une ligne — sa netteté supplémentaire y vaut le coût, et il n'y a pas de paragraphes où halluciner. lowconvient aux brouillons rapides et aux vignettes où une faute isolée importe peu.- Quel que soit le niveau, ne comptez jamais sur le modèle pour orthographier un long corps de texte. Mettez entre guillemets le texte qui doit être correct ; traitez le reste comme des espaces réservés.
FAQ
Puis-je définir 1080×1920 ou des dimensions exactes en pixels ? Non. v4.5 t2i n'accepte que six préréglages image_size — square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. Il n'y a ni champ largeur/hauteur ni aspect_ratio. Choisissez le préréglage le plus proche, et recadrez si vous avez besoin d'un ratio exact.
En quoi cela diffère-t-il d'ideogram-v4 ? Le contrat d'entrée diffère. v4 utilise aspect_ratio plus rendering_speed (turbo/balanced/quality) ; v4.5 a remplacé les deux par les préréglages image_size et les niveaux de prix quality. Si vous avez besoin de la forme de requête de v4, le guide pratique d'ideogram-v4 la couvre, et si vous choisissez encore votre modèle typographique, ideogram-v4 vs Nano Banana 2 vous aidera.
Peut-il modifier une image existante ? Pas sur ce point de terminaison. Le texte-vers-image, c'est ideogram-v4.5/text-to-image ; l'édition (édition par prompt, masques, images de référence) est une route distincte, ideogram-v4.5/image-to-image.
Le texte est-il toujours correct ? Les chaînes courtes entre guillemets — noms de marque, titres, texte de boutons — sont fiables dans chaque recette de cet article. Ce n'est pas le cas des longs textes inventés par le modèle ; relisez chaque rendu, en particulier les petits badges et les légendes.
Comment générer rapidement des variantes ? Réglez num_images jusqu'à 8 dans une seule tâche pour obtenir tout un lot, ou fixez seed et changez un mot pour comparer des prompts à conditions égales.
Exécutez-les vous-même
Chaque prompt ci-dessus peut être copié-collé tel quel — remplacez simplement les chaînes entre guillemets par votre propre marque, titre ou date, puis envoyez. Récupérez le schéma en direct sur la page du modèle ideogram-v4.5/text-to-image, ouvrez la page de tarification pour choisir votre niveau quality, et si c'est votre premier appel à l'API task, le démarrage rapide vous guide pour obtenir une clé et interroger votre première tâche. Mettez votre texte entre guillemets, utilisez medium par défaut, et relisez chaque rendu avant de publier.
Articles similaires
Voir tous les articles →-
Guide d'utilisation
Guide de démarrage pour seedream-5.0-pro/image-to-image : capacités, tarification et points d'intégration
Limites de capacité, mode de facturation et pratiques d'intégration technique du modèle d'édition d'image de ByteDance
-
Guide d'utilisation
Guide de prise en main de la génération d'images par texte avec seedream-5.0-pro : limites de capacités, intégration API et maîtrise des coûts
Point de vue pratique pour les développeurs : des points clés des paramètres à l'estimation du coût de 0,05 $ par image
-
Guide d'utilisation
Guide de prise en main de Hailuo 2.3 Fast image-to-video : limites de capacités, tarification et intégration pratique
Points clés pour les développeurs : choisir et intégrer le modèle image-to-video de MiniMax