API de imágenes Grok Imagine: texto a imagen, imagen a imagen y Quality

Puntos clave

• La API de imágenes Grok Imagine en HiAPI tiene cuatro endpoints: estándar y Quality, y cada versión ofrece texto a imagen e imagen a imagen. Los cuatro comparten exactamente la misma estructura de solicitud; solo cambia el id del modelo.
• La versión estándar cuesta $0.03 por imagen tanto en resolución 1K como 2K. Quality cuesta $0.07 en 1K y $0.10 en 2K. Imagen a imagen cobra un pequeño cargo adicional por cada imagen de referencia (1–3 referencias).
• Con el mismo prompt, la versión estándar dibujó un cono genérico sin asa ni nervaduras de canalización; Quality dibujó una cafetera de filtro por goteo reconocible. Usa la versión estándar para borradores y tareas de gran volumen, y Quality para el producto final.Abre la página del modelo de texto a imagen y pruébalo; las cuentas nuevas reciben 200 créditos gratis.

Qué endpoint usar

id del modelo	Entrada	Precio por imagen	Caso de uso
grok-imagine/text-to-image	Prompt	$0.03 (1K y 2K)	Borradores, generación por lotes, banners ultraanchos
grok-imagine-quality/text-to-image	Prompt	$0.07 (1K) / $0.10 (2K)	Imágenes finales de producto, detalle y materiales
grok-imagine/image-to-image	Prompt + 1–3 imágenes	$0.03 + $0.003 por imagen de referencia	Integrar productos en escenas, retoque por lotes
grok-imagine-quality/image-to-image	Prompt + 1–3 imágenes	$0.08 (1K) / $0.10 (2K) + $0.015 por imagen de referencia	Rever iluminación y cambiar de estilo manteniendo el sujeto idéntico

Precios en tiempo real de HiAPI, consultados el 19 de octubre de 2026. Las tareas fallidas no se cobran.

La edición con una sola imagen de referencia cuesta $0.033 en la versión estándar y $0.095 en Quality 1K. Para conocer la familia completa, incluidos video y Grok Imagine Image 2.0, consulta Precios de la API de Grok Imagine.

El mismo prompt, estándar vs Quality

1:1, 2K, PNG, una ejecución de cada uno:

matte ceramic pour-over coffee dripper on a pure white seamless background, studio softbox lighting, centered, no shadow gradient beyond a soft contact shadow, no text, no watermark, no props, e-commerce product photography, sharp focus

Estándar:

grok-imagine/text-to-image, 1:1, 2K, 2048×2048, $0.03, unos 80 segundos.

Quality:

Generar este prompt en Quality →

grok-imagine-quality/text-to-image, 1:1, 2K, 2048×2048, $0.10, unos 78 segundos.

Las diferencias:

• El objeto en sí: la versión estándar renderizó un cono limpio pero genérico, más parecido a un cuenco que a una cafetera de filtro. Quality dibujó las piezas que la convierten en una cafetera de filtro por goteo: las nervaduras helicoidales interiores, el asa y la base con orificio de drenaje.
• Ambas respetaron el fondo: blanco puro, centrado, con una sola sombra de contacto suave, sin accesorios ni texto.
• Mismo tamaño y velocidad: ambas devolvieron una imagen de 2048×2048 en unos 80 segundos. El nivel cambia el detalle, no el tamaño de salida.

Para un producto conocido, Quality merece los $0.07 extra. Para moodboards o diseño de maquetas donde el objeto es genérico, la versión estándar es suficiente.

Imagen a imagen: coloca tu producto en una escena

Pasa 1–3 URL públicas de imágenes en image_urls y describe los cambios que quieres. Cuando aspect_ratio se establece en auto (el valor predeterminado de imagen a imagen), la salida adopta la forma de la primera imagen de la lista. El mismo prompt y las mismas dos imágenes, solo cambiando el orden, producen dos recortes distintos:

grok-imagine/image-to-image, con la imagen del producto primero, devuelve 1248×832 (3:2).

La misma solicitud, con la imagen de la escena primero, devuelve 1024×1024 (1:1).

Para controlar el recorte, coloca en primer lugar la imagen con la forma que deseas u establece aspect_ratio explícitamente.

En Quality, su fortaleza es cambiar una cosa manteniendo todo lo demás igual. Esta reiluminación conservó el rostro, la chaqueta, la taza y la composición:

Relight this photo as late golden hour: warm low sun coming from the left,
long soft shadows across the table, amber rim light on her hair and jacket.
Keep her face, expression, pose, the corduroy jacket, the marble table, the
coffee cup and the entire composition exactly the same. Photorealistic, same
camera angle, same framing.

grok-imagine-quality/image-to-image, 1K, auto (entrada 3:2, salida 1248×832), una imagen de referencia, $0.095, 39 segundos.

Un patrón que funciona: una frase que indique qué cambiar y luego una lista de todo lo que debe permanecer igual. Para más recetas, consulta Prompts de imagen a imagen de Grok Imagine Quality.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine/text-to-image",
    "input": {
      "prompt": "A lighthouse on a rocky cliff at golden hour, waves crashing below, photorealistic",
      "aspect_ratio": "2:1",
      "resolution": "2k",
      "output_format": "png"
    }
  }'

Recibirás un taskId. Consulta GET https://api.hiapi.ai/v1/tasks/{taskId} hasta que data.status sea success y luego descarga data.output[0].url. El enlace caduca; guarda el archivo de inmediato.

Python: los cuatro endpoints

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, prompt, image_urls=None, timeout_s=300, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    if image_urls:
        body["input"]["image_urls"] = image_urls
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Draft on standard, then re-run the keeper on Quality
draft = generate("grok-imagine/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="1k")
final = generate("grok-imagine-quality/text-to-image", "matte ceramic pour-over dripper, white background",
                 aspect_ratio="1:1", resolution="2k")

# Composite a product into a scene; the first image sets the shape
edit = generate("grok-imagine/image-to-image",
                "Place the product from the first image on the desk in the second image, matching its light",
                image_urls=["https://your-cdn.example.com/product.jpg",
                            "https://your-cdn.example.com/scene.jpg"])

Parámetros

Campo	¿Obligatorio?	Valores	Descripción
prompt	Sí	Texto	Escribe aquí todo lo que quieres o quieres evitar
image_urls	Solo imagen a imagen	1–3 URL	jpeg, png o webp; no se admite SVG; cada imagen de referencia incrementa el precio
aspect_ratio	No	2:1, 20:9, 19.5:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:19.5, 9:20, 1:2; imagen a imagen también acepta auto	auto sigue la primera imagen
resolution	No	1k (predeterminado), 2k	En minúsculas; solo afecta el precio en Quality
output_format	No	jpeg (predeterminado), png, webp

Los formatos ultraanchos 2:1 y 20:9 son adecuados para banners. No hay 21:9; usa 20:9.

Errores que encontrarás

Todos los errores siguientes devuelven HTTP 400 al enviar la solicitud, por lo que no se crea ninguna tarea ni se genera ningún cargo:

• resolution: value must be one of '1k', '2k': enviaste 2K. Usa minúsculas.
• aspect_ratio: value must be one of ...: normalmente es 21:9. Usa 20:9.
• additional properties 'n' not allowed (o seed, negative_prompt, size): esos campos no existen. Una tarea genera una imagen; para varias imágenes, envía varias tareas.
• image_urls: missing required field: imagen a imagen requiere al menos una imagen.

Una clave no válida devuelve 401. Los fallos posteriores a la creación de la tarea aparecen al consultar como status: "fail", así que revisa data.status, no solo el código de estado HTTP.

Preguntas frecuentes

¿Estándar o Quality?

Usa la versión estándar para borradores a $0.03. Cuando el prompt y la maqueta funcionen, vuelve a ejecutar el producto final con Quality. En la versión estándar, 2K cuesta lo mismo que 1K, así que solicita siempre 2k allí.

¿Es lo mismo que Grok Imagine Image 2.0?

No. grok-imagine-image-2.0 es un modelo independiente y más reciente, a $0.052 por imagen. Consulta la Guía de texto a imagen de Grok Imagine Image 2.0.

¿Se pueden obtener varias imágenes en una sola solicitud?

No. No existe el campo n. Envía una tarea por imagen; se ejecutarán en paralelo.

¿Cuánto tiempo dura la salida?

Los enlaces output[0].url caducan. Descarga y almacena el archivo por tu cuenta en cuanto la tarea tenga éxito.

Más salidas reales: Imágenes de catálogo de productos con la versión estándar y Composición de escenas con fotos de producto. Sobre video, consulta la Guía de la API de video de Grok Imagine.