Ideogram

Ideogram V4

ideogram-v4

Modelo de texto a imagen de pesos abiertos, especializado en la representación de texto multilingüe y la salida nativa en 2K, con control de diseño mediante indicaciones JSON y cuadros delimitadores

ideogram-v4

Probar ideogram-v4

Entrada

Creaciones

Ver todas las creaciones

Salida

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

Precios

ideogram-v4 per image

Especificaciones	Precio unitario
TURBO	$0.050
BALANCED	$0.100
QUALITY	$0.170

Descripción general

ideogram-v4 es un modelo de generación de texto a imagen de Ideogram, reconocido por la precisión tipográfica del texto dentro de la imagen, adecuado para desarrolladores que necesitan renderizar directamente texto legible y copies multilingües en materiales como carteles y anuncios. Se invoca a través de la interfaz unificada de HiAPI.ai: basta con introducir un prompt en lenguaje natural y elegir el nivel de velocidad de renderizado para obtener la imagen; admite varias relaciones de aspecto, salida en JPEG/PNG y reproducción con semilla fija, con una estructura de parámetros sencilla que facilita la producción por lotes y la integración.

Puntos clave

El renderizado de texto dentro de la imagen es su principal foco de optimización: el texto indicado en el prompt puede renderizarse directamente como contenido de la imagen, lo que permite completar la maquetación durante la generación en lugar de superponerla después.
Tres niveles de velocidad de renderizado conmutables según necesidad: TURBO, BALANCED y QUALITY corresponden a distintas orientaciones de velocidad y detalle, lo que facilita distribuir las llamadas entre borradores por lotes y salidas de alta calidad.
Semilla y relación de aspecto controlables para reproducir y adaptar: admite fijar seed para reproducir resultados y ofrece cinco relaciones (1:1, 16:9, 4:3, 9:16, 3:4) que cubren los formatos habituales.

Capacidades

Generación de imágenes con texto directamente desde el prompt: al introducir un prompt descriptivo e indicar el texto que debe aparecer, se obtiene una imagen final maquetada, lo que reduce el paso de superponer texto después.

Ajuste por niveles de la velocidad de renderizado: mediante rendering_speed se elige entre TURBO, BALANCED y QUALITY, sopesando velocidad y detalle según el uso.

Relación de aspecto y formato de salida seleccionables: las proporciones de salida cubren formatos cuadrado, horizontal y vertical, y los formatos admiten JPEG y PNG, lo que facilita adaptarla directamente al espacio de publicación o procesarla posteriormente.

Reproducción de resultados con semilla fija: especificar seed permite reproducir el mismo resultado con los mismos parámetros, lo que facilita comparar ajustes finos del prompt o mantener una salida por lotes estable.

Casos de uso

Equipos de diseño que generan por lotes bocetos de carteles con texto: se introduce el copy y la descripción de la maquetación y, en una sola llamada, se obtiene la imagen completa maquetada, útil para la preselección de propuestas y la confirmación de direcciones creativas.
Profesionales de marketing que crean materiales multilingües: se escribe el copy en el idioma objetivo dentro del prompt y se generan imágenes de marketing listas para publicar o para edición posterior.
Desarrolladores que integran una interfaz de generación de imágenes bajo demanda: mediante la interfaz unificada se generan imágenes con la proporción y el formato indicados según necesidad, para incorporarlas a flujos de trabajo de contenido o a canalizaciones automatizadas de producción de materiales.

Limitaciones y recomendaciones de selección

Este modelo solo cubre la generación de texto a imagen y no dispone de capacidades de edición de imágenes ni de imagen a imagen; si se necesita modificar una imagen o repintar una zona, debe elegirse otro modelo. El límite de longitud del prompt es amplio, pero el control de la maquetación sigue dependiendo de la descripción textual, por lo que las maquetaciones complejas requieren ajustes repetidos. El nivel de velocidad de renderizado afecta al detalle y al tiempo de generación; en escenarios por lotes se recomienda validar primero el resultado con un nivel bajo. El texto que debe aparecer en la imagen debe indicarse completo en el prompt, ya que una descripción imprecisa puede provocar desviaciones en el renderizado.

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué es más adecuado Ideogram V4?

Es adecuado para logotipos, carteles, logotipos tipográficos, envases y letreros de tienda que requieren letras latinas precisas.
¿Cómo elegir entre las tres velocidades?

TURBO es adecuado para borradores rápidos; BALANCED equilibra velocidad y calidad; QUALITY es adecuado para detalles finales y letreros complejos.
¿Cómo se distinguen los tres niveles de precio?

TURBO, BALANCED y QUALITY utilizan diferentes niveles de precio por imagen; los importes concretos se rigen por el precio en tiempo real de esta página.
¿Cómo mejorar la precisión del texto en la imagen?

Escribe literalmente en el Prompt el texto que debe mostrarse y especifica el estilo de fuente, la jerarquía, la posición y el contraste con el fondo.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria para generar resultados reproducibles: con la misma semilla y los mismos parámetros se obtienen resultados idénticos; si no se envía, el servidor elige un valor aleatorio.

promptstringObligatoriominLength 1maxLength 10000

Descripción textual del contenido de la imagen. El texto que deba renderizarse debe escribirse explícitamente aquí; la composición tipográfica precisa es la especialidad de este modelo.

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de la imagen de salida, correspondiente a un tamaño predefinido de aproximadamente 1 MP; por defecto 1:1.

Opciones:1:116:94:39:163:4

output_formatstringOpcionalPredeterminado: "jpeg"

Formato de la imagen de salida; por defecto jpeg.

Opciones:jpegpng

rendering_speedstringObligatorioPredeterminado: "BALANCED"

Nivel de velocidad de renderizado: TURBO es el más rápido y económico, QUALITY ofrece el mayor nivel de detalle y cada nivel tiene un precio distinto; por defecto BALANCED.

Opciones:TURBOBALANCEDQUALITY

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",
  "input": {
    "prompt": "…",
    "aspect_ratio": "1:1",
    "output_format": "jpeg",
    "rendering_speed": "BALANCED"
  }
}'

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",
    input: {
      "prompt": "…",
      "aspect_ratio": "1:1",
      "output_format": "jpeg",
      "rendering_speed": "BALANCED"
    }
  }),
});
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",
        "input": {
          "prompt": "…",
          "aspect_ratio": "1:1",
          "output_format": "jpeg",
          "rendering_speed": "BALANCED"
        }
    },
)
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"
    }
  }
}