xAI

Grok Imagine Image 2.0

grok-imagine-image-2.0/text-to-image

Modelo de generación y edición de imágenes de xAI, con un sólido seguimiento de instrucciones y renderizado de maquetaciones complejas; admite la edición iterativa de imágenes a partir de imágenes de referencia y puede generar imágenes en 1K/2K con múltiples relaciones de aspecto

grok-imagine-image-2.0/image-to-image grok-imagine-image-2.0/text-to-image

Probar grok-imagine-image-2.0/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-image-2.0/text-to-image per image

Precio unitario	$0.052

Descripción general

grok-imagine-image-2.0/text-to-image es la vía de entrada exclusivamente de texto del modelo de generación de imágenes de xAI, que se invoca mediante la interfaz unificada de HiAPI.ai. Destaca por convertir prompts largos y detallados en imágenes completas, y muestra un alto grado de seguimiento de instrucciones en escenas complejas, múltiples sujetos, estilos artísticos y requisitos de maquetación con texto tipográfico. Los desarrolladores pueden elegir, según sus necesidades, entre dos niveles de calidad (bajo y medio) y resoluciones de 1K/2K, además de seleccionar la relación de aspecto de salida entre más de diez opciones, desde 1:1 hasta 20:9. Es adecuado para visualización de conceptos, exploración de bocetos de diseño y materiales de difusión en múltiples proporciones.

Puntos clave

Alto seguimiento de prompts largos y complejos: reproduce bien las restricciones creativas detalladas, y los múltiples sujetos y las escenas complejas no se distorsionan con facilidad.
Tipografía y maquetaciones complejas más nítidas: en materiales con disposición de texto, como pósters y portadas, la presentación de la maquetación supera a la de los modelos de imagen habituales.
Opciones de resolución y proporción que cubren la difusión habitual: las dos salidas de 1K/2K, junto con más de diez relaciones de aspecto, encajan directamente en formatos horizontales, verticales y de redes sociales.
Niveles de calidad ajustables según el coste: ofrece dos niveles de calidad, bajo y medio; el nivel bajo renderiza más rápido y es ideal para generar borradores en lote y luego refinar los mejores.

Descripción de capacidades

Generación de imágenes a partir de texto: genera una imagen completa a partir de un prompt de texto largo, ideal para convertir descripciones creativas directamente en borradores visuales evaluables.

Selección de resolución y calidad: permite especificar una salida de 1k o 2k y elegir entre dos niveles de calidad, bajo y medio, para alternar entre la exploración de borradores y la salida final.

Salida en múltiples relaciones de aspecto: admite más de diez opciones, como cuadrada, horizontal, vertical, ultrapanorámica y proporción automática; con una sola configuración se obtiene una imagen que cumple los requisitos de maquetación.

Reproducción con restricciones estrictas del prompt: mantiene una alta fidelidad en descripciones densas en detalles y con maquetación de texto, lo que reduce el número de iteraciones de reescritura del prompt.

Casos de uso

Equipos de arte y diseño: descripción textual de conceptos de escena: genera imágenes conceptuales directamente a partir de descripciones de escena, iluminación y estilo, para propuestas iniciales y alineación de la dirección visual.
Diseño de marketing: materiales de maquetación como pósters y portadas: introduce descripciones con títulos y maquetación y obtén borradores de maquetación claros y legibles, para publicaciones en redes sociales y borradores de materiales de difusión.
Operaciones y publicidad: materiales de difusión en múltiples proporciones: configura distintas relaciones de aspecto a la vez y produce en lote materiales horizontales y verticales, listos para los espacios publicitarios de cada canal.
Ilustración y exploración de estilos: con prompts estilizados, produce rápidamente varias direcciones de ilustración para que el cliente o el director de arte elija entre ellas.

Limitaciones y recomendaciones de selección

La resolución máxima de salida es 2K y cuenta con dos niveles de calidad, bajo y medio, por lo que no puede producir imágenes finales de mayor calidad ni de gran formato más detalladas; en escenarios que requieran imágenes de referencia, repintado local o edición múltiple de varias imágenes, debe utilizarse la vía image-to-image de la misma familia. Esta vía solo acepta prompts de texto y no admite entrada de imágenes. Si la necesidad es obtener imágenes en ultra alta definición o retocar imágenes complejas con múltiples referencias, hay que evaluar otros modelos o flujos de posprocesamiento. El modelo es reciente y la estabilidad a largo plazo y los datos de evaluación independientes son limitados, por lo que se recomienda validar primero su rendimiento con lotes pequeños fuera del flujo oficial.

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué tareas es principalmente adecuado Grok Image 2.0 Text to Image?

Admite niveles de calidad low/medium, salidas en 1K/2K y formatos desde cuadrado hasta ultra panorámico; es adecuado para visuales de producto, editoriales, paisajes y personajes.
¿Grok Image 2.0 Text to Image admite imágenes de referencia?

La ruta actual es de texto a imagen pura, no acepta imágenes de referencia.
¿Qué especificaciones de salida están disponibles?

La página actual muestra 1K, 2K y auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:1, 1:2; las opciones finales disponibles dependen de los parámetros del Playground.
¿Cómo se factura Grok Image 2.0 Text to Image?

Se factura según la cantidad de imágenes generadas con éxito; si hay diferencias entre distintas resoluciones o niveles de calidad, se mostrarán en el precio en tiempo real de la página.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 1

Texto de indicaciones para la generación de imágenes, que determina el contenido y el estilo de la imagen.

qualitystringOpcionalPredeterminado: "medium"

Nivel de calidad de generación; por defecto medium (nivel recomendado), si se selecciona low la generación es más rápida.

Opciones:lowmedium

resolutionstringOpcionalPredeterminado: "1k"

Resolución de la imagen de salida; por defecto 1k.

Opciones:1k2k

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de la imagen de salida; por defecto 1:1.

Opciones:1:116:99:164:33:43:22:32:1

Mostrar todo (6)

1:219.5:99:19.520:99:20auto

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

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