xAI

Grok Imagine

grok-imagine/image-to-image

Modelo de generación creativa de xAI, compatible con edición de imagen a imagen y guía de estilo, con hasta 9 imágenes de referencia para controlar la composición y los personajes; se invoca mediante la interfaz unificada de HiAPI.ai

grok-imagine/image-to-image grok-imagine/image-to-video grok-imagine/text-to-image grok-imagine/text-to-video

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

Precio unitario	$0.030

Descripción general

grok-imagine/image-to-image es un modelo de edición de imágenes lanzado por xAI, que se invoca a través de la interfaz unificada de HiAPI.ai. Utiliza prompts como instrucciones de edición para generar nuevas imágenes a partir de 1 a 3 imágenes de referencia, con soporte para resolución especificada de 1k/2k, 14 relaciones de aspecto y formatos de salida jpeg/png/webp. Es adecuado para desarrolladores que necesitan reescribir, transferir estilo o ajustar la composición tomando imágenes existentes como punto de partida, incorporando capacidades de edición de imágenes controlables en sus propios flujos de producto.

Puntos clave

Edición controlable basada en imágenes de referencia: toma como entrada de 1 a 3 imágenes con URL pública, describe el objetivo de la reescritura mediante un prompt, de modo que el sujeto y la composición se basan en referencias reales en lugar de generarse de la nada.
Amplia cobertura de relaciones de aspecto: admite 14 relaciones de aspecto, desde 2:1 hasta 1:2; la opción auto adopta directamente la proporción de la primera imagen de entrada, adaptándose a publicaciones en horizontal y vertical.
Resolución y formato seleccionables: la salida puede ser de 1k o 2k, y admite tres formatos: jpeg, png y webp, generando directamente archivos utilizables según el uso posterior.

Descripción de capacidades

Edición condicionada por imágenes de referencia: envía de 1 a 3 imágenes públicas en jpeg/png/webp junto con una instrucción de edición, y el modelo genera la imagen reescrita a partir de ellas; es adecuado para realizar modificaciones dirigidas sobre material existente.

Control de relación de aspecto: se puede elegir auto o 14 proporciones fijas; auto sigue la primera imagen de entrada, lo que facilita la producción por lotes y el alineamiento con los tamaños de los espacios publicitarios.

Salida de resolución y formato: la resolución de salida puede ser 1k o 2k, y el formato puede ser jpeg, png o webp; el desarrollador especifica directamente las especificaciones del resultado según la visualización en frontend o el procesamiento posterior.

Soporte de instrucciones largas: el prompt admite hasta 8000 caracteres, lo que permite descripciones de edición detalladas y expresar requisitos complejos de reescritura completos en una sola instrucción.

Escenarios de aplicación

Equipos de diseño: reescritura dirigida de material existente: sube imágenes de productos o de escenarios existentes y describe los puntos de modificación, generando nuevas imágenes que mantienen la composición original, para reemplazar material o crear variantes.
Operaciones de contenido: generación por lotes según el espacio publicitario: genera imágenes horizontales o verticales con parámetros de imagen de referencia y proporción, directamente utilizables para publicaciones multiformato en redes sociales y espacios publicitarios.
Desarrolladores de aplicaciones: integración de funciones de edición de imágenes: encapsula la edición con imágenes de referencia y los parámetros de formato y resolución como una entrada de edición dentro del producto, de modo que los usuarios obtengan el resultado del procesamiento al subir una imagen.

Limitaciones y recomendaciones de selección

La entrada solo acepta de 1 a 3 imágenes públicas en jpeg/png/webp con URL; no admite SVG, y solo se puede producir una imagen por vez. Su ámbito de capacidad es la edición de imágenes basada en referencias; no dispone de generación de vídeo, generación de audio ni generación de imágenes solo con texto, por lo que para esas necesidades se debe elegir el modelo text-to-image o de vídeo de la misma serie. Los escenarios que requieran salida por lotes de varias imágenes o resolución nativa superior a 2k también requerirán otro modelo.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevos modelos: grok-imagine-image-2.0/text-to-image y grok-imagine-ima… Aug 14, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué es adecuado el nivel estándar de Grok Imagine?

Adecuado para la exploración creativa por lotes, material para redes sociales y escenas de paisajes y con sensación cinematográfica. 1k y 2k actualmente tienen el mismo precio, por lo que conviene elegir directamente el nivel de salida superior.
¿Cuál es la diferencia entre el nivel estándar y el nivel Quality?

El nivel estándar prioriza la velocidad y un precio fijo bajo; Quality es una línea de modelo independiente que presta más atención a los materiales, los detalles y la iluminación, y se factura por niveles de 1k/2k.
¿Qué relaciones de aspecto se admiten?

Se admiten 13 relaciones de aspecto horizontales, cuadradas y verticales, desde 2:1 y 20:9 hasta 1:2.
¿Esta página admite imágenes de referencia?

No. Para editar con imágenes de referencia, utiliza grok-imagine/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/image-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 1maxLength 8000

Texto de instrucción de edición, que describe en lenguaje natural el efecto de salida deseado.

image_urlsarrayObligatoriominItems 1maxItems 3

Array de imágenes de referencia de entrada; se deben proporcionar de 1 a 3 URL de imágenes jpeg, png o webp accesibles públicamente; no se admite el formato SVG.

Array [ string ]

resolutionstringOpcionalPredeterminado: "1k"

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

Opciones:1k2k

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de la imagen generada; por defecto auto, es decir, sigue la relación de aspecto de la primera imagen de entrada.

Opciones:auto2:120:919.5:916:94:33:21:1

Mostrar todo (6)

2:33:49:169:19.59:201:2

output_formatstringOpcionalPredeterminado: "jpeg"

Formato de la imagen de salida; 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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1k",
    "aspect_ratio": "auto",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1k",
      "aspect_ratio": "auto",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1k",
          "aspect_ratio": "auto",
          "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"
    }
  }
}