Grok Imagine Video 1.5 API

xAI 的 Grok Imagine Video 1.5 生成模型完整 API 参考。

模型变体

此 API 支持一个模型变体：

支持的宽高比

分辨率选项

Grok Imagine 1.5 Image 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-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;

仅请求体示例：

javascript复制
{
  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'
}

响应格式

初始响应

返回用于轮询的 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. 动作描述：在提示词中包含镜头运动和主体动作
2. 图像质量：使用高质量输入图像以获得更好的动画效果
3. 宽高比：提交前让 aspect_ratio 匹配目标输出格式