xAI

Grok Imagine Quality

grok-imagine-quality/text-to-image

Modelo de generación y edición de imágenes de alta fidelidad de xAI, con renderizado de texto y composición más estables, compatible con salida 1K/2K y edición de consistencia con imágenes de referencia

grok-imagine-quality/image-to-image grok-imagine-quality/text-to-image

Probar grok-imagine-quality/text-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

grok-imagine-quality/text-to-image per image

Especificaciones	Precio unitario
1K	$0.070
2K	$0.100

Descripción general

grok-imagine-quality/text-to-image es un modelo de texto a imagen de alta fidelidad presentado por xAI, perteneciente al segmento de la serie de imágenes Grok Imagine que prioriza la calidad del resultado final. Genera imágenes realistas a partir de indicaciones de texto, admite dos niveles de resolución (1k y 2k), 13 relaciones de aspecto y tres formatos de salida (jpeg, png y webp), con una longitud máxima de 8000 caracteres por indicación. En comparación con la versión estándar, es superior en nitidez de detalles, naturalidad de texturas e iluminación, renderizado de texto dentro de la imagen y estabilidad de la composición, por lo que resulta más adecuado para desarrolladores que necesitan entregar directamente el producto final y no solo para crear borradores creativos.

Aspectos destacados

Nivel de alta fidelidad orientado a una salida de calidad final: los detalles, las texturas y la iluminación son más completos que en el Grok Imagine estándar, y los resultados generados se acercan más a imágenes directamente utilizables.
Compatibilidad con dos niveles de resolución, 1k y 2k: dentro de la misma interfaz se puede pasar de un boceto rápido en baja resolución a un refinado en 2k sin cambiar de modelo ni de ruta.
13 relaciones de aspecto que cubren los formatos más habituales: se pueden especificar directamente desde 1:1 hasta 16:9, 9:16, 20:9 y otras, y adaptarse a pósteres horizontales, redes sociales en vertical y banners de pantalla ancha.
Renderizado de texto dentro de la imagen más preciso: reproduce mejor las imágenes con composición tipográfica y reduce el retrabajo por texto desordenado en escenarios de pósteres y gráficos para redes sociales.

Descripción de capacidades

Generación de imágenes realistas a partir de indicaciones de texto: basta con introducir una descripción para generar una imagen; la indicación puede tener hasta 8000 caracteres, suficiente para incluir descripciones completas de la escena, el estilo y el sujeto.

Resolución y proporción controlables: mediante resolution se elige 1k o 2k, y con aspect_ratio se especifica el formato entre 13 proporciones, de modo que la salida coincide directamente con el diseño del material de destino.

Formato de salida seleccionable: admite tres formatos (jpeg, png y webp) para elegir la codificación adecuada según la visualización en el frontend, el archivo de recursos o el flujo de compresión posterior.

Reproducción de entidades con nombre: ofrece una alta precisión al representar entidades con nombre como marcas, personajes públicos y lugares concretos, por lo que se puede nombrar directamente el sujeto en la indicación.

Escenarios de aplicación

Creación de materiales publicitarios y de marketing: introducir los argumentos de venta del producto y la descripción de la escena para generar un visual principal horizontal o cuadrado en 2k, destinado a Hero Banner, pósteres y materiales de campaña.
Diseño de imágenes y miniaturas para redes sociales: generar portadas con composición tipográfica en proporción 16:9 o 9:16, listas para miniaturas de vídeo e imágenes de redes sociales.
Flujo de trabajo iterativo del boceto al refinado: generar primero por lotes direcciones creativas en resolución 1k y, tras elegir, volver a generar en 2k para la versión de entrega final.
Generación de imágenes de escena con sujetos con nombre: especificar en la indicación un modelo de vehículo, lugar o marca concretos para generar imágenes contextualizadas destinadas a presentaciones conceptuales e ilustraciones de contenido.

Limitaciones y recomendaciones de selección

Sacrifica velocidad de generación a cambio de calidad de imagen: su ritmo de producción es más lento que el de los modelos de imagen Grok Imagine estándar, por lo que no es adecuado para escenarios que requieren grandes volúmenes de bocetos rápidos. En tareas de alta resolución y con exigencias estrictas sobre sujetos con nombre y detalles de la imagen, puede ser necesario ajustar la indicación varias veces para alcanzar el resultado esperado; se recomienda confirmar primero la dirección en 1k y luego generar en 2k. La ruta actual solo cubre texto a imagen; si se necesita una edición dirigida sobre una imagen existente, conviene usar el modelo imagen a imagen de la misma serie. El coste concreto se factura por imagen y se rige por el panel de precios de la plataforma.

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué tipo de imágenes finales es adecuado Grok Imagine Quality?

Es adecuado para key visuals, portadas, conceptos publicitarios e imágenes de escena de alta calidad que requieren materiales, iluminación, atmósfera y detalles más potentes.
¿Cómo se factura 1k y 2k?

1k y 2k utilizan distintas tarifas por imagen; el formato y el formato de salida no generan cargos adicionales; los importes concretos se rigen por el precio en tiempo real de esta página.
¿Por qué no usar directamente el nivel estándar?

El nivel estándar es más adecuado cuando se priorizan los borradores por lotes y la velocidad; elija Quality cuando el resultado final dependa más de los materiales y los detalles.
¿Admite imágenes de referencia?

La ruta actual de texto a imagen no acepta imágenes de referencia; cuando necesites una edición de imágenes de referencia de alta calidad, utiliza grok-imagine-quality/image-to-image.

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: grok-imagine-quality/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 1maxLength 8000

Descripción textual utilizada para generar la imagen, en formato de cadena, que indica el contenido visual deseado.

resolutionstringOpcionalPredeterminado: "1k"

Resolución de la imagen de salida, en formato de cadena, por defecto 1k.

Opciones:1k2k

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de la imagen generada, en formato de cadena, por defecto 1:1.

Opciones:2:120:919.5:916:94:33:21:12:3

Mostrar todo (5)

3:49:169:19.59:201:2

output_formatstringOpcionalPredeterminado: "jpeg"

Formato de la imagen de salida, en formato de cadena, por defecto jpeg.

Opciones:jpegpngwebp

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": "grok-imagine-quality/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "output_format": "jpeg"
  }
}'

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: "grok-imagine-quality/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1k",
      "aspect_ratio": "1:1",
      "output_format": "jpeg"
    }
  }),
});
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": "grok-imagine-quality/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1k",
          "aspect_ratio": "1:1",
          "output_format": "jpeg"
        }
    },
)
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"
    }
  }
}