Grok Imagine Video 1.5

用 Grok Imagine Video 1.5 从提示词或一张图片生成 6–15 秒带声音的视频，480p 或 720p，按秒计费，以任务形式交付。

Grok Imagine Video 1.5 是 xAI 的视频模型。一次请求就能从提示词，或从提示词加一张图片，生成一段 6–15 秒、带声音的 480p 或 720p 视频，画幅为 16:9、9:16 或 1:1。发送请求，保存返回的任务 ID，再从该任务读取生成完成的视频。图片以 URL 形式传入。

模型 ID

模型 ID	输入	分辨率	时长
`grok-imagine-video-1-5`	文本、一张图片	`480p`、`720p`	6–15 秒

当前价格请查看模型页面。

快速示例

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1-5",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in, birdsong. No text, no logos.",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

端点

POST https://api.seedrouter.ai/v1/videos/generations

请求头	值
Authorization	`Bearer YOUR_API_KEY`
Content-Type	`application/json`

响应是一个任务（{"id": "task_...", "status": "processing"}），而不是生成完成的视频。请轮询 GET /v1/tasks/{task_id} 获取结果。请把 API 密钥保存在服务端代码中。

参数

字段	类型	默认值	说明
`model`	string	必填	`grok-imagine-video-1-5`
`prompt`	string	必填	最多 10,000 个字符。使用图片时也必填。
`image_urls`	URL 列表	无	最多一张图片。传入时为图生视频，不传时为文生视频。
`resolution`	enum	`480p`	`480p` 或 `720p`。
`duration`	integer	`8`	6–15 秒。
`aspect_ratio`	enum	`16:9`	`16:9`、`9:16` 或 `1:1`。使用图片时，视频的画幅与图片一致。
`audio`	boolean	`true`	为兼容而接受。每段视频都带声音：设为 `false` 也不会生成无声视频。
`fallback`	object	无	`{"enabled": true}` 或 `{"enabled": false}`。为兼容而接受，但会被忽略。

请求结构是严格校验的：未知字段会被拒绝，而不是被忽略。不支持 callback_url；请改为轮询任务。

图生视频

在 image_urls 中传入一张图片，并在 prompt 中描述接下来发生什么。视频以这张图片开头，画幅与它一致，因此无论 aspect_ratio 设成什么，竖图都会生成竖屏视频。

{
  "model": "grok-imagine-video-1-5",
  "prompt": "The subject slowly turns toward the camera, soft natural light, gentle breeze, quiet room tone.",
  "image_urls": ["https://example.com/start.png"],
  "resolution": "720p",
  "duration": 6
}

媒体输入

图片是一个公开的 HTTP(S) URL。不接受 Base64 data URI：请把文件上传到你自己的存储，再传入它的 URL。请使用不超过 10 MB 的 JPG 或 PNG 图片。

计费维度

当前费率请查看模型定价部分。Grok Imagine Video 1.5 按视频秒数计费，费率由分辨率决定：

cost = duration × rate per second for the resolution

文生视频和图生视频价格相同。时长在请求被受理时就已确定，因此预扣金额就是实际扣费金额。最终扣费请在账户的用量记录中查看。失败的任务不计费。

输出结构

提交后返回任务：

{"id": "task_...", "model": "grok-imagine-video-1-5", "status": "processing", "created_at": 1789689600}

查询任务

GET https://api.seedrouter.ai/v1/tasks/{task_id}

每 10–20 秒轮询一次，直到 status 变为 completed 或 failed。轮询过程中出现网络超时，并不意味着生成失败：请保留任务 ID 并继续查询。不要为了查看进度而再创建一个任务。

完成的任务

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689720,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

在我们的测试中，8 秒的 720p 视频返回为带 AAC 音轨的 MP4（H.264），16:9 的分辨率为 1280 × 720，9:16 为 720 × 1280，1:1 为 720 × 720，从提交到完成用时 111–133 秒。480p 视频用时 45–84 秒。

错误

在任务创建之前被拒绝的请求，会返回 HTTP 错误状态码和一个 error 对象，且不计费。受理之后才失败的任务，在查询时返回 HTTP 200，并带有 status: "failed" 和一个 error 对象。

错误码、HTTP 状态码和重试建议请参见公共错误目录。

{
  "id": "task_...",
  "model": "grok-imagine-video-1-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

如果提交本身超时，请先检查你的任务列表再重新提交：第一次请求有可能已经被受理。

实用建议

描述主体、地点、运镜和光线，并写明想要的声音；声音会与画面一起生成。
先用 480p 出草稿，再用同一个请求以 720p 渲染最终镜头。
要生成竖屏视频，请传入 aspect_ratio: "9:16"，或一张竖图。
加上 no text, no logos，避免出现凭空编造的标记。