
La Ideogram 4.6 API está pensada para un flujo que la mayoría de las APIs de imagen resuelven mal: generar un póster con palabras exactas y después cambiar una línea de ese texto sin redibujar el resto. Esta guía práctica cubre ambas mitades con cuerpos de solicitud: texto en la imagen con ideogram-v4.6, y ediciones de alta precisión, con máscara y localizadas con ideogram-v4.6-edit. Todo lo que aparece aquí se ejecuta contra el modelo Ideogram 4.6 en PoYo, y las cifras proceden de nuestra prueba del día del lanzamiento, el 20 de noviembre de 2026.
Parte 1: texto exacto en la imagen con la Ideogram 4.6 API
La documentación de PoYo da una sola regla para el texto: pon entre comillas en el prompt el texto exacto que debe aparecer en la imagen. Describe dónde va cada línea y qué tamaño tiene, igual que harías en un briefing para un diseñador.
Esta es la solicitud de nuestra prueba del día del lanzamiento (tarea 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
}
}
Devolvió un PNG de 2304×3072 de unos 10.8 MB y se cobró a 40 créditos ($0.20), la tarifa 4K de calidad alta. Las tres líneas entre comillas se renderizaron tal como estaban escritas, incluida la pequeña línea en cursiva. El mismo prompt con quality: very_low y size: 3:4 (tarea BS7M64COKT80JSLX) devolvió un borrador de 768×1024 por 1.6 créditos ($0.008), también con el texto correcto pero con una composición distinta.
Tres hábitos hacen más fiables las solicitudes con texto en producción:
| Hábito | Por qué |
|---|---|
| Una cadena entre comillas por cada línea de texto | Cada línea es una unidad independiente que puedes comprobar y editar después |
| Indica el tamaño y la posición de cada línea («titular grande arriba», «una línea más pequeña debajo») | La jerarquía forma parte de la solicitud, no se deja al azar |
| Revisa la salida antes de publicar | La propia Ideogram aconseja: «Revisa la ortografía y la colocación en el resultado final». |
La expansión del prompt está siempre activada en esta API, así que el modelo puede añadir detalles que no pediste. En nuestro póster añadió un pequeño "EST. 1987" y una dirección web en las esquinas inferiores. Si una maquetación solo debe contener tus palabras, dilo en el prompt y revisa el resultado, o elimina los extras con una edición.
Parte 2: tres formas de editar con ideogram-v4.6-edit
Toda edición recibe exactamente una imagen de origen en image_urls y un prompt. Los ajustes siguientes deciden qué parte de la imagen puede tocar el modelo. Si tu app permite a los usuarios subir el origen, revisarlo antes evita tareas fallidas; la guía de moderación de imágenes muestra una forma de hacerlo.
| Modo | Ajustes | Qué se conserva | Tamaño de salida |
|---|---|---|---|
| Edición normal | edit_precision: regular (por defecto) | La imagen se regenera a partir del prompt | auto o cualquier tamaño preset/personalizado sin máscara |
| Edición de alta precisión | edit_precision: high, context_window: none | Los píxeles sin cambios se restauran | Resolución del origen |
| Edición localizada | edit_precision: high, context_window: auto, mask_url | Todos los píxeles fuera de la región alrededor de la máscara | Resolución del origen |
Ideogram afirma que 4.6 «deja mucho menos desplazamiento de píxeles fuera de tus ediciones» y publica un 90% en ediciones con máscara («cambiar solo el área pintada») frente al 82% de Ideogram 4.5 en su página del modelo. Son puntuaciones de Ideogram. Esto es lo que medimos nosotros.
Edición de alta precisión: cambiar una línea de texto
{
"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
}
}
En nuestra prueba (tarea 672JRU198S22NS8D), el origen era el póster de 2304×3072 de la Parte 1. La salida fue de 2304×3072 con la nueva línea de fecha. Un diff de píxeles frente al original situó todos los píxeles cambiados dentro de un único recuadro, de (471, 2699) a (1826, 2756): la línea de la fecha, alrededor del 1.1% de la imagen. El titular, la ilustración y la pequeña línea en cursiva no cambiaron. El cargo fue de 120 créditos ($0.60), porque una edición de alta precisión conserva la resolución del origen y 2304×3072 supera los 4,194,304 píxeles.
Dos reglas que recordar: edit_precision: high requiere size: auto (o ningún size) y rechaza background.
Edición con máscara: limitar el cambio a un área
Una máscara elimina las dudas sobre dónde se aplica la edición. Debe tener las mismas dimensiones que el origen, negro donde el modelo puede editar y blanco donde debe conservar, y contener ambos. Este fragmento de Python crea una a partir de un recuadro:
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")
Sube la máscara (URL pública o data URI en base64) y añádela a la solicitud:
{
"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"
}
}
Con context_window: auto, solo se edita la región alrededor de la máscara y se conserva la resolución del origen. Una máscara demasiado grande recurre a la edición de la imagen completa. context_window: auto sin mask_url y edit_precision: high se rechaza, y una máscara siempre requiere size: auto. Puedes añadir hasta 3 imágenes de referencia junto con una máscara, por ejemplo un logotipo o una muestra tipográfica, en reference_image_urls.
Parte 3: verifica la edición en tu pipeline
Si tu app promete que «solo ha cambiado el texto», compruébalo. Este es el mismo tipo de comprobación que hicimos con la edición del día del lanzamiento:
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")
Compara el recuadro con el área que querías cambiar, por ejemplo tu máscara. Si se extiende mucho más allá, vuelve a intentarlo con una máscara y context_window: auto, o con un prompt más preciso.
Parte 4: ediciones en varias vueltas y coste
Para una serie de cambios, envía cada resultado como siguiente origen en image_urls y cambia una sola cosa por solicitud. La página de Ideogram describe 4.6 como pensado para «seguir refinando la misma imagen a lo largo de varias vueltas». Cada vuelta es una tarea independiente, facturada según el tamaño de salida:
| Edición de un origen de... | medium | high |
|---|---|---|
| Hasta 4,194,304 píxeles | 12 créditos ($0.06) | 44 créditos ($0.22) |
| Más de 4,194,304 píxeles | 40 créditos ($0.20) | 120 créditos ($0.60) |
Tres cambios de texto en high sobre nuestro póster 4K costarían 360 créditos ($1.80); sobre una versión de 1728×2304 del mismo póster, 132 créditos ($0.66). Descarga cada resultado: los archivos generados se conservan durante 3 días. El artículo de precios incluye más presupuestos, y la guía de la API tiene un bucle de polling que puedes reutilizar en cada vuelta.
Preguntas frecuentes
¿Cómo pongo texto exacto en una imagen con la Ideogram 4.6 API?
Pon cada línea entre comillas en el prompt de una solicitud a ideogram-v4.6 y describe su tamaño y posición. Revisa el resultado antes de publicar.
¿Cómo cambio el texto de una imagen existente con la Ideogram 4.6 API?
Envía la imagen a ideogram-v4.6-edit con un prompt como: Change only the date line to "NEW TEXT". Keep everything else exactly the same. Establece edit_precision: high y size: auto.
¿Qué diferencia hay entre edit_precision regular y high?
regular regenera la imagen a partir del prompt y permite un tamaño nuevo y background. high hace una edición precisa, restaura los píxeles sin cambios y conserva la resolución del origen.
¿Una máscara cambia el precio de la Ideogram 4.6 API? No. Las ediciones se facturan por imagen de salida según la calidad y el nivel de tamaño. La máscara y hasta 3 referencias están incluidas.
¿Por qué una pequeña edición de texto costó 120 créditos?
Una edición de alta precisión con calidad high de un origen de más de 4,194,304 píxeles usa la tarifa de edición 4K de calidad alta. Edita un origen más pequeño o usa medium (40 créditos en 4K, 12 en 2K).
Para la lista completa de parámetros, consulta la referencia de la Ideogram 4.6 Edit API. Para un conjunto de patrones de prompt probados, lee la guía de prompts de la Ideogram 4.6 API.