Grok Imagine 1.5 Video

grok-imagine-1.5-video：文生/图生视频，6–30 秒、480p/720p，异步，按秒计费，用 GET /v1/tasks/{task_id} 查询

POST/v1/videos/generations

GET/v1/tasks/{task_id}

Grok Imagine 通过 /v1 统一异步视频接口调用。提交、轮询、任务对象与错误见接口说明。

项	值
模型	`grok-imagine-1.5-video`
模式	异步（提交 → 轮询 `GET /v1/tasks/{task_id}`）
计费	按实际生成秒数，`480p` 与 `720p` 同价，见计费
媒体保留	`video_url` 最长保留至任务完成后 72 小时

时长 6-30 秒（默认 6），质量档位 480p、720p（默认 480p）。

快速开始

curl https://api.vibelab.me/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.5-video",
    "prompt": "一架纸飞机缓缓滑过安静的工作室，光线柔和",
    "quality": "480p",
    "duration": 6
  }'

提交成功返回 HTTP 202 和任务对象：

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "grok-imagine-1.5-video",
  "status": "pending",
  "created_at": 1772942400,
  "duration": 6,
  "resolution": "480p"
}

查询任务：

curl https://api.vibelab.me/v1/tasks/vt_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY"

模式选择

模式	怎么传参
文生视频	只传 `prompt` 与控制字段
图生视频	加 `image_urls`

请求参数

参数	类型	必填	默认	说明
`model`	string	是	-	固定为 `grok-imagine-1.5-video`
`prompt`	string	是	-	视频内容描述
`quality`	string	否	`480p`	`480p` 或 `720p`
`duration`	integer	否	`6`	`6`–`30` 秒
`image_urls`	string[]	否	-	图生视频参考图 URL，最多 `7` 张，必须公网可访问
`callback_url`	string	否	-	任务到达终态后的 HTTPS 回调地址

请求示例

图生视频：

{
  "model": "grok-imagine-1.5-video",
  "prompt": "画面中的纸飞机缓缓起飞",
  "quality": "720p",
  "duration": 10,
  "image_urls": ["https://example.com/plane.jpg"]
}

响应

用 GET /v1/tasks/{task_id} 查询，状态依次为 pending → running → succeeded / failed（终态）。

字段	类型	说明
`status`	string	`pending`、`running`、`succeeded`、`failed`
`video_url`	string	视频下载地址，仅 `succeeded` 返回，尽快转存
`expires_at`	integer	`video_url` 失效时间，Unix 秒
`credits_charged`	number	本次实际扣费（积分）
`error`	object	仅 `failed` 返回：`{"code": "timeout" \| "upstream_error", "message": "..."}`

完整任务对象字段与示例见接口说明。

计费

grok-imagine-1.5-video 按实际生成时长（秒）计费，480p 与 720p 同价，约 0.096 积分/秒。提交时按请求 duration 预扣，任务结束后按实际时长结算，多退少补；失败全额退回。精确价格与实时变动以定价页为准。

错误

通用错误见接口说明。本模型提交时的参数校验返回 400 invalid_request_error：

`message`	处理
`quality must be one of 480p/720p`	`quality` 传 `480p` 或 `720p`
`duration must be between 6 and 30`	时长传 `6`–`30`

注意事项

顶层 resolution → 不参与档位选择（预扣与校验只读 quality），用 quality 选择质量档位。

Grok Imagine 1.5 Video

本页内容