Ideogram

Ideogram V4.5

ideogram-v4.5/text-to-image

Modelo de generación y edición de imágenes especializado en tipografía nítida y edición local precisa en múltiples pasadas, con resolución nativa 2K, ideal para carteles, logotipos y diseño de packaging

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

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

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

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

Especificaciones	Precio unitario
low	$0.043
medium	$0.086
high	$0.3145

Descripción general

La vía de generación de imágenes a partir de texto de Ideogram V4.5 está orientada a escenarios de desarrollo que requieren una composición tipográfica estable y una calidad de imagen controlable. Basta con introducir un prompt para generar una imagen; admite seis preajustes de tamaño, desde cuadrado hasta panorámico ultraancho, y tres niveles de calidad (bajo, medio y alto), permite fijar una semilla aleatoria para reproducir resultados y ofrece un interruptor de expansión automática del prompt. La renderización de texto dentro de la imagen es su capacidad destacada, por lo que resulta adecuada para producir materiales centrados en la composición tipográfica, como pósteres, banners y bocetos de logotipos, y conviene a los desarrolladores que desean integrar la generación de imágenes en flujos de marketing o diseño.

Aspectos destacados

Renderización de texto estable y legible dentro de la imagen: en materiales cuyo núcleo es la composición de textos, como pósteres, logotipos y envases, los títulos y las frases cortas se muestran con claridad de forma bastante estable.
Niveles de calidad y preajustes de tamaño disponibles: tres niveles de calidad (bajo, medio y alto) combinados con seis preajustes de tamaño permiten elegir la salida según la fase de borrador o de producto final.
Semilla para reproducir los resultados: al fijar el seed se reproduce la misma composición, lo que facilita la comparación de parámetros y la regresión de versiones en la generación por lotes.

Descripción de capacidades

Generación de imágenes con texto y composición tipográfica: el prompt puede tener hasta 10000 caracteres, lo que permite especificar con claridad el texto del título, el estilo tipográfico y los requisitos de maquetación para producir materiales visuales centrados en la composición.

Salida con múltiples preajustes de tamaño: ofrece seis preajustes (cuadrado, cuadrado HD, vertical 4:3 y 16:9, horizontal 4:3 y 16:9) que se ajustan directamente a formatos habituales como pósteres, banners e imágenes para redes sociales.

Ajuste de niveles de calidad: calidad ajustable en tres niveles: low, medium y high; el valor predeterminado es medium, lo que permite usar niveles distintos para borradores por lotes y para la salida final.

Expansión automática del prompt: la expansión del prompt está activada de forma predeterminada y puede completar descripciones breves en una descripción de imagen completa; puede desactivarse cuando se necesita generar una imagen estrictamente conforme al significado original.

Reproducción mediante semilla: se puede especificar explícitamente el seed; con el mismo prompt y los mismos parámetros, los resultados son reproducibles, lo que facilita el ajuste de parámetros por comparación.

Escenarios de aplicación

Diseño de marketing: textos de título para pósteres y banners: desarrolladores o equipos de diseño introducen prompts con textos de título claros y generan imágenes de marketing horizontales o verticales para usarlas directamente en materiales de campaña y páginas de eventos.
Diseño de marca: exploración de bocetos de logotipos e identidades: con prompts breves se generan por lotes bocetos y variantes de logotipos como materiales candidatos para la exploración visual inicial de la marca, que después pasan a un refinamiento manual.
Imágenes de producto: materiales de envase y composición tipográfica: se introducen el nombre del producto y los textos de venta para generar maquetas de envase o imágenes principales del producto que requieren composición tipográfica, destinadas a la revisión de propuestas y a borradores de páginas de detalle.
Productos interactivos: interfaz de generación de imágenes integrada en herramientas de diseño: se integra esta vía en herramientas propias de diseño o contenido para generar imágenes por lotes con semillas fijas y preajustes de tamaño, lo que respalda la producción de materiales basados en plantillas.

Limitaciones y recomendaciones de selección

Esta vía es de generación de imágenes puramente a partir de texto y no acepta imágenes de origen; las necesidades de edición que requieran repintado local o guía mediante imágenes de referencia deben recurrir a la vía de imagen a imagen de la misma familia. Cada solicitud produce una única imagen de forma fija, por lo que la producción por lotes requiere iniciar llamadas en bucle desde el lado del cliente. La calidad de imagen depende del nivel de calidad elegido: el nivel bajo es adecuado para borradores y para el producto final se recomiendan los niveles medio y alto. La expansión del prompt está activada de forma predeterminada; si se necesita generar una imagen estrictamente conforme al texto original, debe desactivarse explícitamente. En escenarios que impliquen composición de textos largos o retoques iterativos de imágenes, se recomienda validar primero el efecto con lotes pequeños.

Novedades

Ver el registro de cambios →

Cambio de función El ID de modelo de generación de imágenes a partir de texto de Ideogram 4.5 cambia a ideogram-v4.5/text-to-image. El id anterior… Oct 21, 2026
Nuevo modelo Se añade documentación de generación de imágenes a partir de texto con ideogram-v4.5 y de edición de imágenes con ideogram-v4.5/image-to-image. Generación a partir de texto… Oct 16, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Qué ediciones puede hacer Ideogram 4.5 Edit?

Puede realizar cuatro tipos de edición: edición global mediante prompt, cambio de estilo con imagen de referencia, repintado local con máscara y refinamiento con Precise Edit. Los cuatro métodos se pueden combinar.
¿Qué campos se requieren como mínimo?

prompt e image_url son obligatorios. reference_image_urls, mask_url, edit_precision, quality, image_size, num_images y seed se añaden según sea necesario.
¿Cuál es la diferencia entre regular y Precise Edit?

Para cambiar palabras y hacer retoques precisos de pequeña escala, elige Precise Edit; para cambiar colores o estilos, elige regular. edit_precision=high corresponde a Precise Edit, que restaura los píxeles que no se han modificado; regular permite cambios con mayor libertad.
¿Son iguales los niveles de calidad de las dos precisiones?

No. regular puede ser very_low, low, medium o high; Precise Edit solo tiene low, medium y high.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: ideogram-v4.5/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para ideogram-v4.5/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcional

Semilla aleatoria utilizada para controlar la aleatoriedad de los resultados generados; si se deja vacía, el sistema la selecciona automáticamente.

promptstringObligatoriominLength 1maxLength 10000

Prompt de generación que describe el contenido de la imagen que se desea generar.

qualitystringOpcionalPredeterminado: "medium"

Nivel de calidad de imagen para texto a imagen; por defecto, medium.

Opciones:lowmediumhigh

image_sizestringOpcionalPredeterminado: "square_hd"

Preajuste de tamaño de la imagen de salida; por defecto, square_hd.

Opciones:square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

num_imagesintegerOpcionalPredeterminado: 1min 1max 1

Número de imágenes generadas por solicitud; este parámetro debe ser 1, por defecto 1.

enable_prompt_expansionbooleanOpcionalPredeterminado: true

Indica si se habilita la expansión de prompt proporcionada por el socio; habilitada por defecto.

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
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"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "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 proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "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"
    }
  }
}