Grok Imagine Video API

xAI Grok Imagine 视频生成模型完整 API 参考文档。

模型版本

本 API 支持两种模型版本：

快速对比

Grok Imagine Text to Video

接口地址

POST /api/v1/video/task

请求参数

必填参数

可选参数

请求示例

javascript复制
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-text-to-video',
    prompt: 'A robot walking through a futuristic city',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9'
  })
});

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

Grok Imagine Image to Video

请求参数

必填参数

可选参数

请求示例

javascript复制
{
  model_name: 'grok-imagine-image-to-video',
  images: ['https://example.com/reference.jpg'],
  prompt: 'Camera slowly zooms in on the subject',
  duration: 6,
  resolution: '720p'
}

响应格式

初始响应

两种模型均返回用于轮询的 task_id：

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

轮询响应

通过 GET /api/v1/video/{taskId} 查询任务状态：

json复制
{
  "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"
        }
      ]
    }
  }
}

状态值说明

• submitted：任务已提交，等待处理
• processing：视频生成中
• succeed：视频生成完成
• failed：视频生成失败

处理时长

典型处理时间：2 到 5 分钟。

最佳实践

1. 创意提示词：Grok Imagine Video 擅长处理富有想象力、细节丰富的场景描述
2. 运动描述：在提示词中加入镜头运动和主体动作的描述
3. 图片质量：使用图片转视频功能时，请提供高质量的输入图片