🚀 Grok 视频生成 最佳实践

通过我们的统一主站 https://ailb.5884.cn，您可以无缝调用 Grok 测试服视频生成 模型。平台自动将统一的视频请求格式转译为您所需的下游供应商接口，极大降低了多模态接入成本。

💡 模型定位与推荐

推荐调用模型名: grok-imagine-video

支持的具体模型变体包括（也可以直接指定）：

• grok-imagine-1.0-video-super-10s-480p
• grok-imagine-1.0-video-super-10s-720p
• grok-imagine-1.0-video-super-20s-480p
• grok-imagine-1.0-video-super-20s-720p
• grok-imagine-1.0-video-super-30s-480p
• grok-imagine-1.0-video-super-30s-720p

🛠️ 快速调用示例（异步轮询模式）

非常重要： Grok 的视频生成耗时较长，因此采用全异步任务提交与轮询机制，不支持阻塞式调用（v1/chat/completions）。请遵循以下两步流程：

第一步：提交视频生成任务

curl -X POST https://ailb.5884.cn/v1/videos \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-token-here" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "一只可爱的小猫在草地上玩毛线球，阳光明媚，电影质感",
    "duration": 10,
    "size": "720p",
    "metadata": {
      "aspect_ratio": "landscape"
    }
  }'

响应示例：

{
  "id": "task_xxxxxxxxxx",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1712123456
}

请务必保存响应中的 id 字段值，后面的轮询查询都要用到。

第二步：轮询查询任务进度

建议客户端使用 while 循环，每隔 5秒 发起一次 GET 请求查询任务状态，直至状态变更为 completed（成功）或 failed（失败）。

curl -X GET https://ailb.5884.cn/v1/videos/task_xxxxxxxxxx \
  -H "Authorization: Bearer sk-your-token-here"

成功响应示例（status 为 completed）：

{
  "id": "task_xxxxxxxxxx",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "completed",
  "progress": 100,
  "created_at": 1712123456,
  "completed_at": 1712123512,
  "metadata": {
    "url": "https://grok.xxx.com/.../generated_video.mp4"
  }
}

提示： 视频的最终下载链接存放在响应体底部的 metadata.url 字段中。

📝 进阶注意事项

1. 并发控制: 视频生成对 GPU 算力消耗极大，请业务方主动控制并发量，避免大批量瞬间提交任务引发限流。
2. 异步退款: 请求在到达服务器并被成功代理后即会执行计费预扣流程。如果模型端生成异常（status: failed），平台会自动在账单中执行退款弥补，详见客户端日志或 Dashboard 的消费记录。
3. 网络超时: 因为您只是提交任务，第一步（POST）返回极快。网络读写超时通常不需要特别长，常规 10~30 秒即可。

💡 随时在 new-api 统一后台 生成您的个人 sk- Token 并查看当前的账户余额。