Ideogram

Ideogram V4.5

ideogram-v4.5/image-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/image-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/image-to-image per image

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

Descripción general

ideogram-v4.5/image-to-image es un modelo orientado a escenarios de edición de imágenes: recibe una imagen fuente principal y permite reescribirla, reemplazarla o repintarla parcialmente mediante prompts. Además de la imagen principal, se pueden adjuntar hasta cuatro imágenes de referencia para restringir el estilo y el contenido, o bien usar una máscara para delimitar con precisión las zonas a modificar; cuenta además con dos niveles de precisión de edición, regular y high, donde high sigue la ruta Precise Edit. Es adecuado para equipos de diseño, comercio electrónico y contenido que necesitan iterar repetidamente sobre materiales, realizando modificaciones controladas sobre imágenes existentes en lugar de generar desde cero.

Puntos clave

La edición de alta precisión reduce la distorsión acumulada tras varias rondas de cambios: cuando edit_precision se establece en high, se sigue la ruta Precise Edit, las modificaciones se concentran en la zona indicada por la instrucción, ideal para pulir una misma imagen ronda tras ronda.
La combinación de imágenes de referencia y máscara controla el alcance de la edición: además de la imagen principal se pueden enviar imágenes de referencia; con máscara, hasta tres; si la máscara coincide con el tamaño de la imagen fuente, se puede limitar el cambio a la zona designada.
Múltiples niveles de calidad y varios formatos disponibles: quality ofrece cuatro niveles de very_low a high; image_size cubre las proporciones habituales cuadradas, horizontales y verticales, y por defecto auto se adapta a la composición.

Descripción de capacidades

Edición de imágenes con lenguaje natural: describe con un prompt el cambio deseado y el modelo repinta sobre la imagen fuente. Es adecuado para reemplazar fondos, ajustar detalles de productos o cambiar la atmósfera de la escena, permitiendo modificaciones a nivel de imagen completa sin máscaras manuales.

Repintado local con máscara: al enviar mask_url junto con una máscara del tamaño correspondiente, solo se repinta la zona cubierta por la máscara y el resto de los píxeles permanece igual; se usa para sustituir elementos localmente, eliminar o añadir contenido.

Estilo guiado por imágenes de referencia: reference_image_urls admite hasta cuatro imágenes, y hasta tres cuando hay máscara; las imágenes de referencia restringen la paleta, el estilo o las características del sujeto para mantener la coherencia en las salidas de varias ediciones.

Niveles de precisión y calidad de edición: al elegir high en edit_precision se activa la edición precisa; quality permite de very_low a high, usando niveles bajos para borradores rápidos al revisar composición o maquetación y niveles altos para la versión final.

Control de formato y semilla: image_size admite proporciones habituales como cuadrada, 4:3 o 16:9, o auto para adaptarse; al fijar seed se pueden reproducir los resultados de edición sobre una misma imagen, lo que facilita la comparación. Cada solicitud genera una imagen.

Escenarios de aplicación

Sustitución local en imágenes de producto existentes para operaciones de comercio electrónico: delimita con una máscara el fondo o la zona del accesorio y repinta con un prompt para obtener imágenes de producto listas para publicar, sin necesidad de volver a fotografiar.
Modificación iterativa de carteles sobre un borrador por parte de equipos de diseño: usa el cartel existente como imagen fuente y ajusta ronda tras ronda la composición y la posición de los textos, con precisión high para reducir artefactos acumulados y obtener una versión entregable.
Exploración de variantes visuales con el mismo estilo por parte de marcas: envía varias imágenes de referencia para unificar el estilo y genera sobre la imagen fuente borradores derivados con distintas paletas, para ampliar materiales y comparar propuestas.
Unificación tonal de materiales existentes por parte de equipos de contenido: ajusta por lotes con prompts e imágenes de referencia la atmósfera estacional o temática de imágenes existentes, generando piezas promocionales adaptadas a distintas temporadas.

Limitaciones y recomendaciones de selección

Cada solicitud genera siempre una sola imagen, por lo que no es adecuado para exploraciones por lotes que requieran grupos de propuestas; la salida máxima es 2K, así que para materiales de impresión de gran formato hay que ampliar por separado. La máscara debe coincidir con el tamaño de la imagen fuente, y las selecciones complejas requieren preparar una máscara de antemano. El resultado de la edición depende de la precisión del prompt; los cambios estructurales grandes (como cambiar por completo la composición) son más adecuados para una regeneración. En modificaciones de varias rondas se recomienda usar siempre el nivel de precisión high para controlar la degradación de calidad.

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/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria para controlar la reproducibilidad de los resultados generados; se toma un número entero, y cuando la misma semilla y el resto de parámetros coinciden, los resultados tienden a ser estables.

promptstringObligatoriominLength 1maxLength 10000

Indicación de generación o edición que describe, en forma de cadena, el contenido visual deseado o la intención de la modificación.

qualitystringOpcionalPredeterminado: "medium"

Nivel de calidad de edición, se toma una cadena, por defecto medium; cuando edit_precision es high, solo se admiten low, medium, high.

Opciones:very_lowlowmediumhigh

mask_urlstringOpcional

URL de la imagen de máscara; el tamaño de la máscara debe coincidir con el de la imagen de origen y se utiliza para delimitar la región de edición.

image_urlstringObligatorio

URL de la imagen de origen principal a editar, que sirve como imagen de entrada para la generación de imagen a imagen.

image_sizestringOpcionalPredeterminado: "auto"

Tamaño de la imagen de salida, se toma una cadena, por defecto auto, y el servicio lo determina automáticamente según la entrada.

Opciones:autosquaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9

num_imagesintegerOpcionalPredeterminado: 1min 1max 1

Número de imágenes de salida, se toma un número entero, por defecto 1; actualmente solo se genera una imagen por solicitud, por lo que num_images debe ser 1.

edit_precisionstringOpcionalPredeterminado: "regular"

Modo de precisión de edición, se toma una cadena, por defecto regular; al establecerse en high se activa la edición precisa Precise Edit.

Opciones:regularhigh

reference_image_urlsarrayOpcionalmaxItems 4

Arreglo de URL de imágenes de referencia, con un máximo de cuatro imágenes de referencia; cuando se proporciona una máscara, se utilizan como máximo tres.

Array [ string ]

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/image-to-image",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "image_url": "…",
    "image_size": "auto",
    "num_images": 1,
    "edit_precision": "regular"
  }
}'

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/image-to-image",
    input: {
      "prompt": "…",
      "quality": "medium",
      "image_url": "…",
      "image_size": "auto",
      "num_images": 1,
      "edit_precision": "regular"
    }
  }),
});
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/image-to-image",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "image_url": "…",
          "image_size": "auto",
          "num_images": 1,
          "edit_precision": "regular"
        }
    },
)
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"
    }
  }
}