Generación Grok 5 Imagine

Documentación de la API

Utiliza estos endpoints para enviar trabajos Grok 5 Imagine y verificar su estado. Cada llamada consume créditos basados en el modelo utilizado.

Autenticación

Todas las solicitudes deben incluir tu clave API dentro del Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Las claves faltantes o inválidas devuelven 401 Unauthorized.

POST

https://grok5imagine.com/api/generate

Crear tarea de generación

Envía un nuevo trabajo Grok 5 Imagine. La llamada devuelve inmediatamente un task_id mientras que el renderizado se completa de forma asíncrona.

Parámetro	Tipo	Requerido	Descripción
model	string	No	Modelo a usar: grok-imagine/text-to-image (predeterminado), text-to-video, image-to-video o upscale.
input	object	Sí	Objeto de parámetros de entrada que contiene prompt, image_urls o task_id según el modelo.
input.prompt	string (max 5000 chars)	No	Prompt de texto que describe qué generar (requerido para text-to-image y text-to-video).
input.image_urls	string[]	No	Array de URLs de imágenes (requerido para image-to-video).
input.task_id	string	No	ID de tarea anterior para upscale o generación image-to-video.
callback_url	string	No	URL del webhook para recibir notificaciones de finalización de tareas.
public	boolean	No	Exponer la tarea a galerías públicas.

Consumo de Créditos

Los créditos se deducen cuando se crea la tarea. Los trabajos fallidos se reembolsan automáticamente.

Modelo	Créditos deducidos
grok-imagine/text-to-image	5
grok-imagine/text-to-video	24
grok-imagine/image-to-video	24
grok-imagine/upscale	12

Ejemplo de solicitud

{
  "model": "grok-imagine/text-to-image",
  "input": {
    "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
  }
}

Ejemplo de respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "IN_PROGRESS"
  }
}

GET / POST

https://grok5imagine.com/api/status

Verificar estado de la tarea

Utiliza este endpoint para consultar el registro más reciente. Cuando la tarea aún está en IN_PROGRESS, consultamos al proveedor una vez más antes de responder.

Parámetro	Tipo	Requerido	Descripción
task_id	string	Sí	ID devuelto por /generate. Enviar a través de query (?task_id=) o cuerpo JSON.

Campo	Descripción
task_id	ID devuelto desde /generate.
status	SUCCESS (ÉXITO)
request	Copia sanitizada del payload enviado.
response	Objeto que contiene el array resultUrls cuando el estado es SUCCESS.
consumed_credits	Créditos cobrados por la tarea (0 cuando se reembolsa).
error_message	Error del proveedor cuando el estado es FAILED.
created_at	Marca de tiempo UTC en que se almacenó el trabajo.

Ejemplo de solicitud

GET https://grok5imagine.com/api/status?task_id=n31b6d54c8f4b4c4e8kie
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://grok5imagine.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "n31b6d54c8f4b4c4e8kie"
}

Ejemplo de respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n31b6d54c8f4b4c4e8kie",
    "status": "SUCCESS",
    "request": {
      "model": "grok-imagine/text-to-image",
      "input": {
        "prompt": "A majestic dragon flying over a neon-lit cyberpunk city"
      }
    },
    "response": {
      "resultUrls": [
        "https://static.gogloai.com/grok-imagine/image_001.png"
      ]
    },
    "consumed_credits": 5,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Manejo de Errores

401 Unauthorized - Clave API faltante o inválida.
402 Payment Required - El saldo de crédito no pudo cubrir la deducción.
429 Too Many Requests - Reduzca la cadencia de sondeo o la tasa de solicitudes.
500 - Problema transitorio; reintente con retroceso exponencial.