API de Grok Imagine: genera una imagen con el SDK de Pipe2

Para acceder a la API de Grok Imagine mediante Pipe2, ejecuta Image Generator con model: 'grok-imagine-image'. Envía un prompt de texto, consulta el estado mediante el ID de ejecución y recupera la imagen generada. Esta guía usa la API y la autenticación de Pipe2; no muestra una solicitud directa a la API de xAI.

Selecciona Grok de forma explícita

El slug del pipeline es image-generator; el identificador del modelo va dentro de input. Usa grok-imagine-image para el modelo estándar o grok-imagine-image-quality para Grok Imagine Quality. Auto puede elegir otro motor: fija el modelo si necesitas usar Grok.

El ejemplo usa el modelo estándar, ninguna imagen de referencia y quality: 'fast': una configuración de Grok válida y de coste mínimo para este flujo. Fast selecciona una salida de 1K; auto y hd, de 2K. Actualmente, Grok estándar tiene el mismo precio base por imagen en ambos tamaños; fast no supone un descuento adicional. Las referencias añaden coste. Antes de lanzar un conjunto de solicitudes, usa EstimatePipelineCost con el mismo slug y los mismos datos de entrada.

Ejecuta el ejemplo del SDK

Instala el paquete con npm install @pipe2-ai/sdk. Guarda el código como grok-image.mjs, asigna a PIPE2_TOKEN un token de acceso personal de Pipe2 en tu entorno y ejecuta node grok-image.mjs. Tu cuenta debe tener créditos suficientes. Mantén el token en el servidor.

import { createClient } from '@pipe2-ai/sdk';

const token = process.env.PIPE2_TOKEN;
if (!token) throw new Error('Set PIPE2_TOKEN');
const client = createClient(token);
const input = {
  model: 'grok-imagine-image',
  prompt: 'A small red paper boat on a rain-darkened stone step, soft morning light, editorial photograph, no text.',
  quality: 'fast',
  enhance_prompt: false,
};
const { run_pipeline } = await client.RunPipeline({
  pipeline_slug: 'image-generator',
  input,
});

for (let attempt = 0; attempt < 60; attempt++) {
  const { pipeline_runs_by_pk: run } = await client.GetPipelineRun({
    id: run_pipeline.run_id,
  });
  if (!run) throw new Error('Run not found');
  if (run.status === 'failed' || run.status === 'cancelled') {
    throw new Error(run.error_message ?? run.status);
  }
  if (run.status === 'completed') {
    const url = run.assets?.[0]?.url;
    if (!url) throw new Error('Completed run has no image asset');
    console.log(url);
    process.exit(0);
  }
  await new Promise((resolve) => setTimeout(resolve, 3000));
}
throw new Error(`Polling timed out; resume with run ID ${run_pipeline.run_id}`);

Esta es la solicitud equivalente al pipeline:

{
  "pipeline_slug": "image-generator",
  "input": {
    "model": "grok-imagine-image",
    "prompt": "A small red paper boat on a rain-darkened stone step, soft morning light, editorial photograph, no text.",
    "quality": "fast",
    "enhance_prompt": false
  }
}

Consulta la documentación del SDK de TypeScript para conocer el cliente que usa este módulo JavaScript y la referencia de la API para consultar la API pública.

Conserva el ID hasta que la imagen esté lista

RunPipeline devuelve un ID de ejecución, no la imagen terminada. GetPipelineRun obtiene el estado y los archivos de salida. El ejemplo se detiene si la ejecución falla o se cancela, comprueba que una ejecución completada tenga un archivo y muestra la URL de la primera imagen. Limita la consulta a 60 comprobaciones con esperas de tres segundos; es una decisión de la aplicación, no una garantía del tiempo de generación.

Si se agota el plazo de consulta, vuelve a comprobar el mismo ID en lugar de enviar otra generación idéntica. Guarda ese ID en cuanto se acepte la solicitud. En producción, gestiona también los errores de red y conserva la referencia del archivo donde la aplicación la necesite.

Añade referencias solo cuando hagan falta

Basta con un prompt de texto. Ambos modelos de imagen de Grok admiten hasta tres reference_images en JPEG o PNG, con un máximo de 20 MB por imagen. No aceptan reference_videos en este pipeline. Los formatos disponibles son 1:1, 16:9, 9:16, 4:3 y 3:4; el ejemplo usa el formato cuadrado predeterminado.

enhance_prompt: false evita que se reescriba el prompt antes de generar la imagen cuando la solicitud contiene solo texto. Describe el sujeto, el entorno, el encuadre y la luz, y revisa el resultado antes de usarlo. Para definir mejor la composición, consulta la guía de prompts de Grok Imagine. Si añades referencias, explica qué aporta cada una y vuelve a estimar el coste de la solicitud modificada.