Grok Imagine Video 1.5 API

Referencia completa de la API para los modelos de generación Grok Imagine Video 1.5 de xAI.

Variantes del Modelo

Esta API admite una variante de modelo:

Relaciones de Aspecto Compatibles

Opciones de Resolución

Grok Imagine 1.5 Image to Video

Endpoint

POST /api/v1/video/task

Parámetros de Solicitud

Obligatorios

Opcionales

Solicitud de Ejemplo

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'grok-imagine-v1.5-image-to-video',
    image_url: 'https://example.com/reference.jpg',
    prompt: 'Subtle camera motion, subject holds pose',
    aspect_ratio: '16:9',
    duration: 10,
    resolution: '720p'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Ejemplo solo del body:

javascriptCopiar
{
  model_name: 'grok-imagine-v1.5-image-to-video',
  image_url: 'https://example.com/reference.jpg',
  prompt: 'Subtle camera motion, subject holds pose',
  aspect_ratio: '16:9',
  duration: 10,
  resolution: '720p'
}

Formato de Respuesta

Respuesta Inicial

Devuelve un task_id para polling:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Respuesta de Polling

Haz polling a GET /api/v1/video/{taskId} para comprobar el estado:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valores de Estado

• submitted: Tarea aceptada y en espera de ser procesada
• processing: Generación de video en progreso
• succeed: Generación de video completada
• failed: Generación de video fallida

Tiempo de Procesamiento

Tiempo de procesamiento típico: 2-5 minutos.

Mejores Prácticas

1. Descripción de Movimiento: Incluye movimiento de cámara y movimiento del sujeto en los prompts
2. Calidad de Imagen: Usa imágenes de entrada de alta calidad para mejores resultados de animación
3. Relación de Aspecto: Ajusta aspect_ratio al formato de salida objetivo antes de enviar