Ideogram

Ideogram V4.5

ideogram-v4.5/text-to-image

Modèle de génération et d'édition d'images réputé pour la clarté de sa typographie et ses modifications locales précises sur plusieurs tours, natif en 2K, idéal pour les affiches, les logos et le design d'emballage

ideogram-v4.5/image-to-image ideogram-v4.5/text-to-image

Essayer ideogram-v4.5/text-to-image

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

ideogram-v4.5/text-to-image per image

Spécifications	Prix unitaire
low	$0.043
medium	$0.086
high	$0.3145

Présentation du positionnement

La voie text-to-image d'Ideogram V4.5 s'adresse aux scénarios de développement nécessitant une composition typographique stable et une qualité d'image contrôlable. Il suffit de saisir un prompt pour générer une image, avec six préréglages de dimensions allant du carré à l'ultra-large panoramique et trois niveaux de qualité (bas, moyen, élevé), la possibilité de fixer une graine aléatoire pour reproduire les résultats, ainsi qu'un interrupteur d'expansion automatique du prompt. Le rendu de texte dans l'image est sa capacité phare, adaptée à la production de supports centrés sur la typographie tels que affiches, bannières et ébauches de logos, et convient aux développeurs qui souhaitent intégrer la génération d'images dans des chaînes de production marketing ou design.

Points clés

Rendu de texte dans l'image stable et lisible — dans les supports centrés sur la composition textuelle comme les affiches, logos ou packaging, les titres et phrases courtes s'affichent de manière relativement stable et nette.
Niveaux de qualité et préréglages de dimensions — trois niveaux de qualité (bas, moyen, élevé) associés à six préréglages de dimensions permettent d'ajuster la sortie selon la phase de brouillon ou de rendu final.
Graine reproductible — la fixation d'une seed permet de reproduire la même composition, ce qui facilite les comparaisons de paramètres et les régressions de version lors de la génération par lots.

Description des capacités

Génération d'images à base de texte et de typographie : le prompt peut atteindre 10 000 caractères, ce qui permet de préciser le texte du titre, le style de police et les exigences de mise en page pour produire des supports visuels centrés sur la typographie.

Sortie avec plusieurs préréglages de dimensions : six préréglages sont proposés — carré, carré HD, portrait 4:3 et 16:9, paysage 4:3 et 16:9 — correspondant directement aux formats courants comme les affiches, bannières et images pour réseaux sociaux.

Réglage du niveau de qualité : trois niveaux ajustables — low, medium, high — avec medium par défaut, permettant d'utiliser des niveaux différents pour les essais par lots et la sortie finale.

Expansion automatique du prompt : activée par défaut, elle complète une description courte en une description d'image complète ; elle peut être désactivée lorsqu'il faut générer strictement selon le sens d'origine.

Reproductibilité par graine : la seed peut être spécifiée explicitement ; avec un prompt et des paramètres identiques, les résultats sont reproductibles, ce qui facilite le réglage comparatif des paramètres.

Scénarios d'application

Design marketing : textes de titres pour affiches et bannières — un développeur ou une équipe design saisit un prompt contenant un texte de titre explicite et produit une image marketing en paysage ou en portrait, directement utilisable pour les supports publicitaires et les pages d'événement.
Design de marque : exploration d'ébauches de logos et d'identités — génération par lots d'ébauches et de variantes de logos à partir de prompts courts, comme candidats pour l'exploration visuelle initiale de la marque, avant retouche manuelle.
Images produit : packaging et supports typographiques — saisie du nom du produit et des arguments de vente pour produire des maquettes de packaging ou des visuels principaux nécessitant une composition typographique, destinés à la revue de projet et aux brouillons de pages de détail.
Produits interactifs : interface de génération d'images intégrée aux outils de design — intégration de cette voie dans ses propres outils de design ou de contenu, avec génération par lots à partir de graines fixes et de préréglages de dimensions, pour soutenir la production de supports modélisés.

Limites et conseils de choix

Cette voie est du text-to-image pur : elle n'accepte pas d'image source, et les besoins d'édition par repeinture locale ou guidage par image de référence doivent recourir à la voie image-to-image de la même famille. Chaque requête produit une seule image ; la production par lots nécessite des appels en boucle côté client. La qualité d'image dépend du niveau de qualité choisi : le niveau bas convient aux brouillons, les niveaux moyen et élevé sont recommandés pour les rendus finaux. L'expansion du prompt est activée par défaut ; il faut la désactiver explicitement pour générer strictement selon le texte d'origine. Pour les scénarios impliquant une composition de texte long ou des retouches itératives sur plusieurs tours, il est conseillé de valider d'abord les résultats sur de petits lots.

Nouveautés

Voir le journal des modifications →

Changement de fonctionnalité L'ID du modèle de génération d'images à partir de texte Ideogram 4.5 devient ideogram-v4.5/text-to-image. L'ancien id… Oct 21, 2026
Nouveau modèle Ajout de la documentation pour la génération d'images ideogram-v4.5 et l'édition d'images ideogram-v4.5/image-to-image. La génération d'images… Oct 16, 2026

Questions fréquentes

Voir toutes les questions →

Quelles modifications peut effectuer Ideogram 4.5 Edit ?

Il permet quatre types de modifications : l'édition globale par prompt, le changement de style à partir d'une image de référence, la retouche locale avec masque et le peaufinage avec Precise Edit. Ces quatre méthodes peuvent être combinées.
Quels sont les champs obligatoires au minimum ?

prompt et image_url sont obligatoires. Ajoutez reference_image_urls, mask_url, edit_precision, quality, image_size, num_images et seed selon vos besoins.
Quelle est la différence entre regular et Precise Edit ?

Pour modifier du texte et effectuer des retouches ponctuelles, choisissez Precise Edit ; pour changer de couleur ou de style, choisissez regular. edit_precision=high correspond à Precise Edit, qui restaure les pixels non modifiés ; regular offre des modifications plus libres.
Les niveaux de qualité sont-ils identiques pour les deux précisions ?

Non. regular propose very_low, low, medium, high ; Precise Edit propose uniquement low, medium, high.

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 : ideogram-v4.5/text-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour ideogram-v4.5/text-to-image et la route default — voir le tableau des paramètres ci-dessous.

seedintegerOptionnel

Graine aléatoire utilisée pour contrôler le caractère aléatoire des résultats générés ; laissée vide, elle est choisie automatiquement par le système.

promptstringRequisminLength 1maxLength 10000

Prompt de génération décrivant le contenu de l'image souhaitée.

qualitystringOptionnelDéfaut: "medium"

Niveau de qualité d'image pour la génération texte-vers-image, par défaut medium.

Options：lowmediumhigh

image_sizestringOptionnelDéfaut: "square_hd"

Préréglage de dimensions de l'image de sortie, par défaut square_hd.

Options：square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

num_imagesintegerOptionnelDéfaut: 1min 1max 1

Nombre d'images générées par requête ; ce paramètre doit être 1, par défaut 1.

enable_prompt_expansionbooleanOptionnelDéfaut: true

Indique s'il faut activer l'extension de prompt fournie par le partenaire, activée par défaut.

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": "ideogram-v4.5/text-to-image",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "image_size": "square_hd",
    "num_images": 1,
    "enable_prompt_expansion": true
  }
}'

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.5/text-to-image",
    input: {
      "prompt": "…",
      "quality": "medium",
      "image_size": "square_hd",
      "num_images": 1,
      "enable_prompt_expansion": true
    }
  }),
});
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.5/text-to-image",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "image_size": "square_hd",
          "num_images": 1,
          "enable_prompt_expansion": True
        }
    },
)
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"
    }
  }
}