Google

Imagen 4

imagen-4.0

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

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

imagen-4.0 per image

Precio unitario	$0.060

Descripción general

imagen-4.0 es el modelo de texto a imagen de gama estándar de la serie Imagen 4; solo acepta indicaciones de texto y es adecuado para necesidades de generación diarias que buscan un equilibrio entre calidad de imagen y coste de generación. Admite indicaciones de hasta 5000 caracteres y una indicación negativa de hasta 500 caracteres, permite especificar la relación de aspecto entre 1:1, 16:9, 9:16, 3:4, 4:3 y auto, y puede usar seed para hacer reproducible la misma configuración. En comparación con la versión rápida, es más adecuado para la generación por lotes que requiere una calidad de imagen estable pero no busca el detalle extremo; los desarrolladores pueden integrarlo en su propio flujo de generación llamándolo a través de la interfaz unificada de HiAPI.ai.

Puntos clave

Mejoras específicas en la representación de texto dentro de la imagen: los estudios muestran que esta serie mejora notablemente la generación de texto dentro de la imagen respecto a la generación anterior, lo que la hace adecuada para bocetos de diseño que necesitan texto legible en la imagen.
Compatibilidad con indicación negativa y reproducción mediante seed: se puede usar negative_prompt para excluir elementos no deseados y seed para fijar y reproducir la misma configuración de generación, lo que facilita la iteración y la verificación de regresión.
Seis relaciones de aspecto especificables directamente: aspect_ratio abarca cuadrado, horizontal, vertical y 3:4, 4:3, además de auto para selección automática, lo que evita el recorte posterior.
Posicionamiento claro de la gama estándar: la misma serie incluye las gamas Fast y Ultra; la versión estándar es adecuada como opción predeterminada para la generación por lotes diaria, y se puede mejorar si se necesita una calidad final superior.

Descripción de capacidades

Generación de texto a imagen: basta con introducir una descripción textual para devolver una imagen; el límite de la indicación es de 5000 caracteres, suficiente para contener una descripción relativamente completa del sujeto, el estilo y la composición.

Parámetros de control de generación: negative_prompt se usa para declarar los elementos que se deben excluir y seed para reproducir el mismo resultado; la combinación de ambos permite que el proceso de generación sea ajustable y rastreable.

Adaptación de relación de aspecto: la proporción de salida se puede elegir entre cuadrado, horizontal, vertical y 4:3, 3:4, o se puede delegar en auto para que decida la proporción de composición según el contenido de la indicación.

Presentación de texto legible: cuando se describe el contenido del texto de la imagen en la indicación, el modelo procesa mejor la representación de texto que la generación anterior, pero aún es necesario verificar manualmente los glifos finales.

Casos de uso

Imágenes para redes sociales de equipos de marketing: describir la imagen con texto según el tema de la campaña, elegir una proporción horizontal o vertical y producir imágenes por lotes para publicarlas directamente en los canales de contenido.
Carteles y bocetos de presentación para diseñadores: generar borradores de carteles o portadas con texto usando indicaciones que incluyan el texto del título, como referencia de dirección visual antes de la maquetación.
Imágenes conceptuales de producto que requieren un estilo fijo: fijar seed y relación de aspecto, y ajustar repetidamente la indicación en torno al mismo producto para producir imágenes conceptuales de estilo coherente para la revisión de propuestas.
Integración automatizada en flujos de generación: usar la generación de texto a imagen como un paso de la canalización, con el programa pasando la indicación y los parámetros de proporción, para producir materiales por lotes y enviarlos a la revisión posterior.

Limitaciones y recomendaciones de selección

La entrada solo admite texto; no se puede editar ni repintar parcialmente a partir de una imagen existente. Los parámetros solo ofrecen indicación, indicación negativa, relación de aspecto y seed, sin controles más detallados como pasos o intensidad de estilo. Aunque el texto en las imágenes ha mejorado respecto a la generación anterior, se recomienda verificar cada imagen antes de entregarla. Si se necesita un mayor seguimiento de las indicaciones y más detalle, se puede considerar la gama Ultra de la misma serie; si se valora más la velocidad de generación, se puede elegir la gama Fast. Este modelo no es adecuado para escenarios que requieran entrada de imagen o un control local preciso.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedstringOpcionalmaxLength 500

Semilla aleatoria opcional para la reproducibilidad de los resultados generados; se pasa como cadena de texto.

promptstringObligatoriominLength 1maxLength 5000

Descripción textual de la imagen que se va a generar; es la entrada principal para la generación de imágenes.

aspect_ratiostringObligatorio

Controla la relación de aspecto de la imagen de salida, especificada como cadena de texto.

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

negative_promptstringOpcionalmaxLength 5000

Describe los elementos que deben excluirse de la imagen generada; se pasa como texto.

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