
La Ideogram 4.6 API te da acceso al modelo de imagen más reciente de Ideogram a través de un único endpoint REST en PoYo: ideogram-v4.6 para text-to-image e ideogram-v4.6-edit para editar una imagen de origen con una máscara y imágenes de referencia opcionales. Las salidas llegan hasta 4096 píxeles por lado, los precios empiezan en 1.6 créditos ($0.008) por imagen y todas las solicitudes usan la misma API key que el resto de PoYo. Esta página explica qué es Ideogram 4.6, sus límites exactos, los niveles de precio y lo que medimos el día del lanzamiento.
¿Qué es Ideogram 4.6?
Ideogram 4.6 es un modelo de generación y edición de imágenes de Ideogram, lanzado el 19 de noviembre de 2026. Ideogram lo describe como «nuestro modelo de edición más preciso hasta la fecha» y afirma que «genera imágenes en 4K nativo», «sin upscaling». En su página del modelo, Ideogram también dice que el modelo «deja mucho menos desplazamiento de píxeles fuera de tus ediciones y mantiene el color con más precisión».
Ideogram lo respalda con puntuaciones por tarea en calidad alta, comparando 4.6 con 4.5:
| Tarea (descripción de Ideogram) | Ideogram 4.6 | Ideogram 4.5 |
|---|---|---|
| Color exacto: recolorear un objeto con el código hex de una marca | 83% | 46% |
| Detalle de producto: reparar un pequeño defecto en una foto de producto | 86% | 61% |
| Fotos de producto: escenificar, cambiar el estilo y reetiquetar productos | 88% | 66% |
| Consistencia de personaje: mantener reconocible a una persona en una escena nueva | 85% | 69% |
| Ediciones con máscara: cambiar solo el área pintada | 90% | 82% |
Estas son cifras de Ideogram, no mediciones de PoYo. Para una integración por API, apuntan a tres tipos de solicitudes que vale la pena enviar aquí:
- Pósters, etiquetas y gráficos para redes con palabras exactas: pon el texto entre comillas en el prompt.
- Ediciones que deben dejar todo lo demás intacto: una fecha nueva en un flyer, un producto recoloreado, un único detalle cambiado.
- Impresiones grandes: tamaños personalizados de hasta 4096 píxeles por lado sin un paso de upscaling aparte.
La Ideogram 4.6 API en resumen
| Text-to-image | Edición | |
|---|---|---|
| ID de modelo en PoYo | ideogram-v4.6 | ideogram-v4.6-edit |
| Endpoint de envío | POST https://api.poyo.ai/api/generate/submit | El mismo |
| Resultado | Consulta GET /api/generate/status/{task_id} o usa callback_url | Igual |
| Entradas | prompt | prompt + exactamente una imagen en image_urls, mask_url y reference_image_urls opcionales |
| Imágenes por solicitud | 1 a 8 (n) | 1 a 8 (n) |
| Niveles de calidad | very_low, low, medium (por defecto), high | Los mismos |
| Lanzamiento de Ideogram | 19 de noviembre de 2026 | 19 de noviembre de 2026 |
| Documentación | Referencia de la Ideogram V4.6 API | Referencia de Ideogram V4.6 Edit |
Los dos IDs comparten autenticación, polling y facturación, así que una app puede generar con uno y refinar con el otro sin una segunda integración.
Límites y campos de la solicitud
| Campo | Regla en PoYo |
|---|---|
prompt | Obligatorio, de 1 a 10,000 caracteres, debe contener texto que no sea solo espacios. Pon entre comillas el texto exacto que debe aparecer en la imagen. |
size | auto (por defecto), 1:1 (512×512), 1:1 HD (1024×1024), 4:3, 3:4, 16:9, 9:16 o un WIDTHxHEIGHT personalizado |
| Tamaño personalizado | x en minúscula, ambos lados de 256 a 4096 píxeles y múltiplos de 32, relación de aspecto entre 1:6 y 6:1 |
quality | very_low, low, medium (por defecto), high; very_low solo hasta 4,194,304 píxeles |
n | Entero de 1 a 8 |
background | transparent u opaque; solo text-to-image y ediciones normales |
seed | Entero de 0 a 2,147,483,647 |
image_urls (edición) | Exactamente una imagen de origen, URL HTTP(S) pública o data URI en base64, siempre como array |
mask_url (edición) | Mismas dimensiones que el origen; el negro se edita, el blanco se conserva; requiere size: auto |
reference_image_urls (edición) | De 0 a 4 imágenes, o como máximo 3 con máscara |
edit_precision (edición) | regular (por defecto) o high; high requiere size: auto y rechaza background |
context_window (edición) | none (por defecto) o auto; auto requiere mask_url y edit_precision: high |
Cualquier otro campo dentro de input se rechaza con un error unsupported fields. Los archivos generados están disponibles durante 3 días, así que cópialos a tu propio almacenamiento.
Precios de la Ideogram 4.6 API
PoYo factura por imagen de salida, según la calidad y el nivel de tamaño. «2K» significa una salida de hasta 4,194,304 píxeles (2048×2048 en área); todo lo que sea mayor es «4K». 1 crédito = $0.005.
| Calidad | Text-to-image 2K | Text-to-image 4K | Edición 2K | Edición 4K |
|---|---|---|---|---|
very_low | 1.6 créditos ($0.008) | no disponible | 1.6 créditos ($0.008) | no disponible |
low | 6 créditos ($0.03) | 12 créditos ($0.06) | 6 créditos ($0.03) | 12 créditos ($0.06) |
medium | 12 créditos ($0.06) | 24 créditos ($0.12) | 12 créditos ($0.06) | 40 créditos ($0.20) |
high | 20 créditos ($0.10) | 40 créditos ($0.20) | 44 créditos ($0.22) | 120 créditos ($0.60) |
size: auto y los seis presets son siempre 2K en text-to-image. En las ediciones con size: auto, la salida conserva la geometría del origen, así que un origen grande cae en el nivel 4K. Estos precios coinciden con la tabla por imagen de la página del modelo de Ideogram; el desglose de precios los aplica a solicitudes reales.
Lo que medimos el día del lanzamiento
El equipo de PoYo ejecutó estas pruebas en la API de producción de PoYo el 20 de noviembre de 2026. El prompt era un póster serigrafiado de "NORTHBOUND JAZZ FESTIVAL" con las líneas "JUNE 12-14 · RIVERSIDE PARK" y "Three nights. Twenty-one bands. Free entry before 6 PM."
| Tarea | Solicitud | Salida | Cobrado |
|---|---|---|---|
M4WA9OIQXVV80DHG | ideogram-v4.6, quality: high, size: 2304x3072, n: 1 | Un PNG de 2304×3072, unos 10.8 MB | 40 créditos ($0.20) |
BS7M64COKT80JSLX | Mismo prompt, quality: very_low, size: 3:4 | PNG de 768×1024 | 1.6 créditos ($0.008) |
672JRU198S22NS8D | ideogram-v4.6-edit sobre el primer póster, edit_precision: high, context_window: none, size: auto, quality: high | PNG de 2304×3072 | 120 créditos ($0.60) |
Todo el texto de los dos primeros pósters salió tal como estaba escrito, incluida la pequeña línea en cursiva; el borrador tenía una composición distinta. El prompt de edición fue: Change only the date line to "JULY 3-5 · RIVERSIDE PARK". Keep everything else exactly the same. Un diff de píxeles frente al original encontró todos los píxeles cambiados dentro de un único recuadro, de (471, 2699) a (1826, 2756), alrededor del 1.1% de la imagen; el resto no cambió. La edición usó el nivel 4K de calidad alta porque una edición de alta precisión conserva la resolución del origen. La guía de texto y ediciones precisas recorre esa solicitud paso a paso.
Tu primera solicitud a la Ideogram 4.6 API
curl https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.6",
"input": {
"prompt": "A minimalist poster titled \"SUMMER JAZZ NIGHTS\", bold typography",
"size": "2048x3072",
"quality": "high",
"n": 2
}
}'
2048x3072 son 6,291,456 píxeles, así que esta solicitud se factura con la tarifa 4K de calidad alta: 2 × 40 = 80 créditos ($0.40). La respuesta incluye data.task_id con el estado not_started. Consulta el endpoint de estado hasta que sea finished y lee las imágenes en data.files, o pasa un callback_url en el nivel superior. Comprueba siempre code en el cuerpo: algunos errores de validación devuelven HTTP 200 con code: 400. La guía de la API incluye un bucle de polling en Python con límite de tiempo y un cuerpo para cada modo de entrada.
Dónde está disponible Ideogram 4.6
Ideogram ofrece 4.6 en su propia app y en su API, con dos endpoints: Generate y Precise Edit. En PoYo lo llamas con la misma clave que usas para todos los demás modelos, el mismo flujo de tareas y callbacks, y un Playground en la página del modelo que muestra el precio antes de cada ejecución. En PoYo, las imágenes de referencia se envían a través de ideogram-v4.6-edit; el ID de text-to-image solo acepta un prompt más los controles de tamaño, calidad, n, background y seed.
Qué solicitudes enviar a cada modelo
| Solicitud | ID de modelo y ajustes |
|---|---|
| Borradores y exploración de maquetación | ideogram-v4.6, very_low o low, un tamaño preset, n hasta 8 |
| Pósters finales y gráficos para redes de hasta 2048×2048 en área | ideogram-v4.6, high, tamaño personalizado como 1728x2304 |
| Impresión y arte de gran formato | ideogram-v4.6, de low a high, tamaño personalizado por encima de 4,194,304 píxeles |
| Cambiar un detalle y conservar el resto | ideogram-v4.6-edit, edit_precision: high |
| Repintar una región de una imagen grande | ideogram-v4.6-edit, mask_url, edit_precision: high, context_window: auto |
| Cambiar el estilo con una referencia, nuevo tamaño de salida | ideogram-v4.6-edit, edit_precision: regular, reference_image_urls, size personalizado |
¿Vienes de Ideogram 4.5? La comparativa 4.6 vs 4.5 enumera los cambios de campos, las nuevas reglas de tamaño y el precio de una misma solicitud. Si estás valorando otras APIs de imagen en PoYo, consulta la introducción a la MAI Image 2.7 API y la comparativa Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5.
Preguntas frecuentes
¿Cuál es el ID de modelo de la Ideogram 4.6 API?
Usa ideogram-v4.6 para text-to-image e ideogram-v4.6-edit para editar. ideogram-4-6 es solo el slug de la página en PoYo y no es un ID de modelo.
¿Cuánto cuesta la Ideogram 4.6 API?
Desde 1.6 créditos ($0.008) por imagen en very_low 2K. Una imagen medium 2K por defecto cuesta 12 créditos ($0.06), y high cuesta 20 créditos ($0.10) en 2K y 40 créditos ($0.20) en 4K. Las ediciones 4K de calidad alta cuestan 120 créditos ($0.60).
¿Cuál es la imagen más grande que puede devolver la Ideogram 4.6 API? Los tamaños personalizados llegan hasta 4096 píxeles por lado, en múltiplos de 32, con una relación de aspecto entre 1:6 y 6:1. Todo lo que supere 4,194,304 píxeles se factura en el nivel 4K.
¿La Ideogram 4.6 API renderiza texto en las imágenes? Sí, pon las palabras exactas entre comillas en el prompt. En nuestra prueba del lanzamiento, un póster de 2304×3072 mostró el titular, la línea de la fecha y una pequeña línea en cursiva tal como estaban escritos. Aun así, Ideogram recomienda revisar la ortografía y la colocación en el resultado final.
¿Puede la Ideogram 4.6 API devolver imágenes transparentes?
Sí. Establece background en transparent para text-to-image o ediciones normales. Las ediciones de alta precisión rechazan background.
¿La Ideogram 4.6 API es compatible con el SDK de OpenAI?
No. Es una API de tareas asíncronas: envía a /api/generate/submit y luego consulta /api/generate/status/{task_id} o recibe un callback.