Recursos para Desarrolladores

Documentacion de la API de Grok 5 Imagine

Integra el modelo Grok 5 Imagine de xAI en tus aplicaciones. Soporte para generacion de texto a imagen, texto a video e imagen a video con una API REST sencilla.

Autenticacion

La API de Grok 5 Imagine utiliza autenticacion mediante Bearer Token. Envia tu clave de API en el encabezado de la solicitud.

Autenticacion

Authorization: Bearer sk-your-api-key-here

Manten tu clave de API segura. No la compartas en codigo del lado del cliente.

Precios

Tipo	Costo	Descripcion
Texto a Imagen `(text2img)`	5 Creditos	Genera imagenes a partir de prompts de texto usando Grok 5 AI.
Texto a Video `(text2video)`	24 Creditos	Genera videos a partir de prompts de texto usando Grok 5 AI.
Imagen a Video `(img2video)`	24 Creditos	Genera videos a partir de imagenes usando Grok 5 AI.

Crear Tarea

POSThttps://grok5ai.com/api/generate

Generacion Asincrona

Precios

Los creditos varian segun el modelo: text2img cuesta 5 creditos, text2video e img2video cuestan 24 creditos cada uno.

Inicia una tarea de generacion. La API devuelve un task_id de inmediato, que puedes usar para consultar el resultado.

Parametros del Cuerpo

Parametro	Tipo	Requerido	Descripcion
model	string	Requerido	Modelo a usar: text2img, text2video o img2video.
prompt	string	Condicional	La descripcion de texto para la generacion. Maximo 5000 caracteres. Requerido para text2img y text2video.
image_urls	array	Condicional	Matriz de URLs de imagenes para el modo img2video. Requerido si no se proporciona task_id.
task_id	string	Condicional	ID de tarea de una generacion anterior para usar como imagen de entrada. Requerido si no se proporciona image_urls.
callback_url	string	Opcional	URL de Webhook para notificaciones de finalizacion de tarea.

Ejemplos de Solicitud

Ejemplo Texto a Imagen (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2img",
    "prompt": "A serene mountain landscape at sunset"
  }'

Ejemplo Texto a Video (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text2video",
    "prompt": "A timelapse of clouds moving over mountains"
  }'

Ejemplo Imagen a Video (cURL)

curl -X POST https://grok5ai.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "img2video",
    "image_urls": ["https://example.com/image.jpg"]
  }'

Respuesta Exitosa

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS"
  }
}

Respuesta de Error

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Consultar Estado

GEThttps://grok5ai.com/api/status

Consulta este endpoint para verificar el progreso de tu tarea. Recomendamos consultar cada 5-10 segundos.

Parametros de Consulta

Parametro	Tipo	Descripcion
task_id	string	El ID de tarea recibido desde el endpoint de generacion. Requerido

Valores de Estado

PENDINGTarea en cola

IN_PROGRESSEn progreso

SUCCESSCompletada

FAILEDOcurrio un error

cURL

curl -X GET "https://grok5ai.com/api/status?task_id=grok5abc123def456img" \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuesta (En progreso)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Respuesta (Completada)

{
  "code": 200,
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Respuesta (Fallida)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "grok5abc123def456img",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Codigos de Error

Codigo	Descripcion
200	Exito
400	Bad Request - Parametros invalidos (falta el prompt, modelo invalido, etc.)
401	Unauthorized - Clave de API faltante o invalida
404	Not Found - El ID de tarea no existe
500	Internal Server Error - Por favor, reintenta o contacta al soporte

Necesitas ayuda?

Visita nuestro canal de soporte o envianos un correo electronico.

Contactar a Soporte