how-tos

Ideogram 4.6 API pour le texte dans l’image et les éditions haute précision

Poyo.ai Team
8 min read
Share:

Ideogram 4.6 API : texte dans l’image et éditions haute précision

L’Ideogram 4.6 API est conçue pour un workflow que la plupart des API d’image gèrent mal : générer une affiche avec des mots exacts, puis modifier une ligne de ce texte sans redessiner le reste. Ce tutoriel couvre les deux moitiés avec des corps de requête : le texte dans l’image avec ideogram-v4.6, et les éditions haute précision, masquées et localisées avec ideogram-v4.6-edit. Tout ce qui suit s’exécute sur le modèle Ideogram 4.6 de PoYo, et les chiffres proviennent de notre test du jour du lancement, le 20 novembre 2026.

Partie 1 : du texte exact dans l’image avec l’Ideogram 4.6 API

La documentation PoYo donne une seule règle pour le texte : mettez entre guillemets dans le prompt le texte exact à afficher dans l’image. Décrivez où va chaque ligne et quelle taille elle a, comme vous briefiez un graphiste.

Voici la requête de notre test du jour du lancement (tâche M4WA9OIQXVV80DHG) :

{
  "model": "ideogram-v4.6",
  "input": {
    "prompt": "Screen-printed concert poster for \"NORTHBOUND JAZZ FESTIVAL\". Big bold condensed headline at the top, a stylized upright bass and saxophone silhouette over a river at dusk in deep teal, burnt orange and cream. Below the art, the line \"JUNE 12-14 · RIVERSIDE PARK\" and a smaller line \"Three nights. Twenty-one bands. Free entry before 6 PM.\" Fine paper grain, crisp letterforms, generous margins.",
    "size": "2304x3072",
    "quality": "high",
    "n": 1
  }
}

Elle a renvoyé un PNG 2304×3072 d’environ 10.8 MB et a été facturée 40 crédits ($0.20), le tarif 4K high. Les trois lignes entre guillemets ont été rendues telles qu’écrites, y compris la petite ligne en italique. Le même prompt avec quality: very_low et size: 3:4 (tâche BS7M64COKT80JSLX) a renvoyé un brouillon 768×1024 pour 1.6 crédits ($0.008), lui aussi avec un texte correct mais une composition différente.

Trois habitudes rendent les requêtes avec texte plus fiables en production :

HabitudePourquoi
Une chaîne entre guillemets par ligne de texteChaque ligne est une unité distincte que vous pouvez vérifier, puis éditer
Indiquer la taille et la position de chaque ligne (« grand titre en haut », « une ligne plus petite en dessous »)La hiérarchie fait partie de la requête au lieu d’être laissée au hasard
Vérifier la sortie avant publicationIdeogram le recommande lui-même : « Vérifiez l’orthographe et le placement dans le résultat final. »

L’expansion du prompt est toujours active sur cette API : le modèle peut donc ajouter des détails que vous n’avez pas demandés. Sur notre affiche, il a ajouté un petit « EST. 1987 » et une adresse web dans les coins inférieurs. Si une mise en page ne doit contenir que vos mots, dites-le dans le prompt et vérifiez le résultat, ou supprimez les ajouts par une édition.

Partie 2 : trois façons d’éditer avec ideogram-v4.6-edit

Chaque édition prend exactement une image source dans image_urls et un prompt. Les réglages ci-dessous déterminent quelle part de l’image le modèle peut toucher. Si votre application permet aux utilisateurs de téléverser la source, la filtrer au préalable évite des tâches en échec ; le guide de modération d’images montre une façon de le faire.

ModeRéglagesCe qui est conservéTaille de sortie
Édition classiqueedit_precision: regular (par défaut)L’image est régénérée à partir du promptauto ou toute taille prédéfinie/personnalisée sans masque
Édition haute précisionedit_precision: high, context_window: noneLes pixels inchangés sont restaurésRésolution de la source
Édition localiséeedit_precision: high, context_window: auto, mask_urlChaque pixel en dehors de la région autour du masqueRésolution de la source

Ideogram affirme que 4.6 « laisse beaucoup moins de dérive de pixels en dehors de vos éditions » et annonce 90% pour les éditions masquées (« ne modifier que la zone peinte ») contre 82% pour Ideogram 4.5 sur sa page modèle. Ce sont les scores d’Ideogram. Voici ce que nous avons mesuré.

Édition haute précision : modifier une ligne de texte

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Change only the date line to \"JULY 3-5 · RIVERSIDE PARK\". Keep everything else exactly the same.",
    "image_urls": [
      "https://example.com/northbound-poster.png"
    ],
    "edit_precision": "high",
    "context_window": "none",
    "size": "auto",
    "quality": "high",
    "n": 1
  }
}

Dans notre test (tâche 672JRU198S22NS8D), la source était l’affiche 2304×3072 de la partie 1. La sortie faisait 2304×3072, avec la nouvelle ligne de date. Une comparaison pixel par pixel avec l’original a placé tous les pixels modifiés dans un seul rectangle, de (471, 2699) à (1826, 2756) : la ligne de date, environ 1.1% de l’image. Le titre, l’illustration et la petite ligne en italique étaient inchangés. Le montant facturé était de 120 crédits ($0.60), car une édition haute précision conserve la résolution de la source et 2304×3072 dépasse 4,194,304 pixels.

Deux règles à retenir : edit_precision: high exige size: auto (ou aucun size), et refuse background.

Édition masquée : limiter la modification à une zone

Un masque supprime toute incertitude sur l’endroit de l’édition. Il doit avoir les mêmes dimensions que la source, être noir là où le modèle peut éditer, blanc là où il doit conserver, et contenir les deux. Ce snippet Python en construit un à partir d’un rectangle :

from PIL import Image, ImageDraw

source = Image.open("poster.png")
mask = Image.new("L", source.size, 255)                       # white = keep
ImageDraw.Draw(mask).rectangle((440, 2660, 1860, 2800), fill=0)  # black = edit
mask.save("date-line-mask.png")

Téléversez le masque (URL publique ou data URI base64) et ajoutez-le à la requête :

{
  "model": "ideogram-v4.6-edit",
  "input": {
    "prompt": "Change the sign text to \"OPEN LATE\"",
    "image_urls": [
      "https://example.com/storefront.png"
    ],
    "mask_url": "https://example.com/sign-mask.png",
    "edit_precision": "high",
    "context_window": "auto",
    "quality": "high"
  }
}

Avec context_window: auto, seule la région autour du masque est éditée et la résolution de la source est conservée. Un masque trop grand bascule vers une édition de l’image entière. context_window: auto sans mask_url et edit_precision: high est rejeté, et un masque exige toujours size: auto. Avec un masque, vous pouvez ajouter jusqu’à 3 images de référence, par exemple un logo ou un échantillon de police, dans reference_image_urls.

Partie 3 : vérifier l’édition dans votre pipeline

Si votre application promet que « seul le texte a changé », vérifiez-le. C’est le même type de contrôle que celui que nous avons effectué sur l’édition du jour du lancement :

from PIL import Image, ImageChops

before = Image.open("before.png").convert("RGB")
after = Image.open("after.png").convert("RGB")
assert before.size == after.size, "high-precision edits keep the source size"

diff = ImageChops.difference(before, after).convert("L").point(lambda v: 255 if v > 32 else 0)
box = diff.getbbox()
print("changed box:", box)
if box:
    area = (box[2] - box[0]) * (box[3] - box[1])
    print(f"box covers {area / (before.width * before.height):.2%} of the image")

Comparez le rectangle avec la zone que vous vouliez modifier, par exemple votre masque. S’il déborde largement, réessayez avec un masque et context_window: auto, ou avec un prompt plus précis.

Partie 4 : éditions en plusieurs tours et coût

Pour une série de modifications, renvoyez chaque résultat comme source image_urls suivante et ne changez qu’une chose par requête. La page d’Ideogram décrit 4.6 comme conçu pour « continuer à affiner la même image sur plusieurs tours ». Chaque tour est une tâche distincte, facturée selon la taille de la sortie :

Édition d’une source...mediumhigh
Jusqu’à 4,194,304 pixels12 crédits ($0.06)44 crédits ($0.22)
Au-delà de 4,194,304 pixels40 crédits ($0.20)120 crédits ($0.60)

Trois modifications de texte en high sur notre affiche 4K coûteraient 360 crédits ($1.80) ; sur une version 1728×2304 de la même affiche, 132 crédits ($0.66). Téléchargez chaque résultat : les fichiers générés sont conservés 3 jours. L’article sur les prix propose d’autres budgets, et le guide de l’API contient une boucle de polling réutilisable à chaque tour.

Questions fréquentes

Comment placer un texte exact dans une image avec l’Ideogram 4.6 API ? Mettez chaque ligne entre guillemets dans le prompt d’une requête ideogram-v4.6 et décrivez sa taille et sa position. Vérifiez le résultat avant publication.

Comment modifier le texte d’une image existante avec l’Ideogram 4.6 API ? Envoyez l’image à ideogram-v4.6-edit avec un prompt comme : Change only the date line to "NEW TEXT". Keep everything else exactly the same. Réglez edit_precision: high et size: auto.

Quelle est la différence entre edit_precision regular et high ? regular régénère l’image à partir du prompt et autorise une nouvelle taille et background. high effectue une édition précise, restaure les pixels inchangés et conserve la résolution de la source.

Un masque change-t-il le prix de l’Ideogram 4.6 API ? Non. Les éditions sont facturées par image produite, selon le palier de qualité et de taille. Le masque et jusqu’à 3 références sont inclus.

Pourquoi une petite modification de texte a-t-elle coûté 120 crédits ? Une édition haute précision en qualité high d’une source de plus de 4,194,304 pixels utilise le tarif d’édition 4K high. Éditez une source plus petite, ou utilisez medium (40 crédits en 4K, 12 en 2K).

Pour la liste complète des paramètres, consultez la référence de l’API Ideogram 4.6 Edit. Pour une série de modèles de prompts, lisez le guide des prompts de l’Ideogram 4.6 API.

Share: