Google

Imagen 4

imagen-4.0-ultra

Serie de generación de imágenes a partir de texto de Google, centrada en la representación de texto dentro de la imagen y la iluminación compleja; ofrece tres niveles (Fast, Estándar y Ultra) que permiten elegir entre calidad y coste

imagen-4.0 imagen-4.0-fast imagen-4.0-ultra

Probar imagen-4.0-ultra

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

imagen-4.0-ultra per image

Precio unitario	$0.090

Descripción general

imagen-4.0-ultra es el modelo de texto a imagen de la familia Imagen 4 orientado a una salida de alta fidelidad, adecuado para tareas de generación que requieren un seguimiento preciso de las indicaciones, composiciones de escena complejas y texto nítido dentro de la imagen. Los desarrolladores generan imágenes a partir de indicaciones de texto mediante la interfaz unificada de HiAPI.ai, con relación de aspecto opcional 1:1, 16:9, 9:16, 3:4, 4:3 o auto, lo que lo convierte en la opción para la fase de salida final de visuales de marca, borradores de diseño y conceptos.

Aspectos destacados

Mayor fidelidad a las indicaciones y detalles más nítidos: como versión Ultra, su alineación con las indicaciones de texto es más fuerte y la salida se ajusta más a la descripción de la instrucción, ideal para la generación de imágenes de calidad final.
Mejora en la representación de texto dentro de la imagen: en comparación con generaciones anteriores, hay una mejora evidente en la generación de texto dentro de la imagen, lo que hace más utilizables contenidos como carteles e identificaciones.
Generación directa según la relación de aspecto: el campo obligatorio aspect_ratio admite 1:1, 16:9, 9:16, 3:4, 4:3 y auto, lo que permite adaptarse a los formatos de ubicación sin recortes posteriores.

Descripción de capacidades

Texto a imagen de alta fidelidad: genera imágenes de estilo realista a partir de indicaciones de texto, adecuado para salidas de nivel profesional de marca y diseño; las indicaciones tienen un límite de longitud, por lo que es necesario expresar la intención completa dentro de un número limitado de caracteres.

Composición compleja y representación de iluminación: admite necesidades de generación con composiciones de escena complejas e iluminación compleja, lo que reduce los reintentos múltiples y aprovecha cada llamada para producir una imagen utilizable.

Control de la relación de aspecto: especifica la relación de salida mediante el campo obligatorio aspect_ratio, que cubre formatos cuadrados, horizontales, verticales y de 3:4 y 4:3, adaptándose a las especificaciones de material de distintos canales.

Restricción mediante indicaciones negativas: el campo opcional negative_prompt describe los elementos que se desea evitar, lo que sirve para acotar el contenido de la imagen y reducir la probabilidad de aparición de elementos no deseados.

Generación reproducible: el parámetro opcional seed permite una generación reproducible, lo que facilita fijar resultados y comparar el efecto de distintas indicaciones durante la depuración y la producción por lotes.

Casos de uso

Equipos de marca y marketing: textos de propuesta de valor del producto: introduce el tono de marca y la descripción de la propuesta de valor para generar materiales visuales de alta fidelidad utilizables directamente en publicidad y canales de redes sociales.
Equipos de diseño: necesidades de texto en carteles y presentaciones: introduce la descripción de un diseño que incluya texto de titular para obtener un borrador con texto dentro de la imagen relativamente nítido, útil como referencia e iteración de diseño para carteles y materiales de presentación.
Diseño conceptual: descripciones de composición e iluminación complejas: introduce requisitos de escena, encuadre e iluminación para generar conceptos de alta fidelidad, útiles para definir la dirección visual en fases iniciales y presentar propuestas.
Equipos de desarrollo: canalizaciones de generación por lotes: realiza llamadas por lotes con seed y parámetros de relación fijos para producir imágenes finales de estilo uniforme e integrarlas en flujos de producción de contenido o gestión de materiales.

Limitaciones y recomendaciones de selección

Solo acepta entrada de texto y no admite edición con entrada de imagen; la longitud de las indicaciones está limitada por el esquema, por lo que las descripciones demasiado largas deben simplificarse. Aunque el texto dentro de la imagen ha mejorado, sigue siendo necesaria la verificación humana antes de publicar. El coste por imagen de la versión Ultra es superior al de otras versiones de la misma familia; para borradores por lotes se recomienda filtrar primero con las versiones estándar o Fast y después generar las imágenes finales con este modelo; cuando se requiera edición de imágenes o capacidad de imagen a imagen, debe elegirse otro modelo.

Novedades

Ver el registro de cambios →

Cambio de función El ID del modelo Imagen 4 cambia a imagen-4.0… Oct 21, 2026
Nuevo modelo Nueva documentación de generación de imágenes de Google Imagen 4 Oct 14, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué es adecuado Imagen 4?

Es adecuado para imágenes cotidianas de productos, estilos de vida y contenido. Al describir con claridad el sujeto, la escena, los materiales y la iluminación, se obtienen imágenes listas para revisión, que suelen usarse en imágenes principales de productos, borradores de campañas de marca e ilustraciones para artículos.
¿Qué relaciones de aspecto admite Imagen 4?

Admite 6: 1:1, 16:9, 9:16, 3:4, 4:3 y auto. aspect_ratio es obligatorio; en el Playground de esta página, el valor predeterminado es 16:9.
¿Cuál es la longitud máxima de un prompt?

Máximo 5,000 caracteres. El prompt es obligatorio; se recomienda organizarlo en el orden de sujeto, escena, material, iluminación y texto.
¿Se pueden excluir elementos no deseados?

Sí, con negative_prompt. Es un parámetro opcional, de hasta 5.000 caracteres, adecuado para excluir texto superfluo, marcas de agua o fondos desordenados.

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: imagen-4.0-ultra

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedstringOpcionalmaxLength 500

Semilla aleatoria opcional, en forma de cadena; al pasar la misma seed se puede reproducir el resultado de la generación con la misma entrada.

promptstringObligatoriominLength 1maxLength 5000

Descripción textual de la imagen a generar, en forma de cadena, utilizada para especificar el contenido de la escena.

aspect_ratiostringObligatorio

Relación de aspecto de la imagen de salida, en forma de cadena, obligatoria.

Opciones:1:116:99:163:44:3auto

negative_promptstringOpcionalmaxLength 5000

Prompt negativo opcional, en forma de cadena, utilizado para describir los elementos que se desea evitar en la imagen generada.

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": "imagen-4.0-ultra",
  "input": {
    "prompt": "…",
    "aspect_ratio": "…"
  }
}'

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: "imagen-4.0-ultra",
    input: {
      "prompt": "…",
      "aspect_ratio": "…"
    }
  }),
});
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": "imagen-4.0-ultra",
        "input": {
          "prompt": "…",
          "aspect_ratio": "…"
        }
    },
)
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"
    }
  }
}