视频 / Grok
grok-imagine-video
文生/首帧/多图参考；4-15秒（默认8秒）；480P/720P；14图；按秒；不支持参考视频；首帧与参考图二选一。
分组 #155「【视频】多模型按秒计费」 · Key 需属于该分组
文生视频图生视频参考图按秒计费
价格—
近 100 次成功率—
平均耗时—
能力与限制
| 时长 | 4–15 s（默认 8 s） |
| 分辨率 | 480p / 720p |
| 画面比例 | 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 |
| 参考图 | 最多 14 张 |
| 参考视频 | 不支持 |
| 参考音频 | 不支持 |
| 首尾帧 | 不支持 |
| 生成声音 | 上游未说明 |
| 计费 | 按秒：档位单价 × 秒数 |
模型简介与素材限制
根据上游模型广场 2026-10-31 的简介与参数表同步。本站售价见页首实时价格。
| 项目 | 说明 |
|---|---|
| 模型简介 | 文生/首帧/多图参考；4-15秒（默认8秒）；480P/720P；14图；按秒；不支持参考视频；首帧与参考图二选一。 |
- 首帧 image 与多图参考 images 二选一；参考图最多 14 张，不支持参考视频。
请求参数
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | 固定为 grok-imagine-video |
prompt | string | 必填 | 提示词 |
duration_seconds | integer | 必填 | 时长（秒）：4–15；上游默认 8；本站计费必填 |
aspect_ratio | string | 可选 | 画面比例：1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3；上游默认 "16:9" |
resolution | string | 必填 | 分辨率：480p / 720p；上游默认 "480p"；本站计费必填 |
image | string | 可选 | 首帧图片（图生视频）；公网可访问的 HTTPS 直链 |
images | array | 可选 | 参考图片（多图参考生视频），最多 14 项；公网可访问的 HTTPS 直链 |
n | integer | 可选 | 生成数量；固定 1 |
查询与下载
- 创建任务后拿到
id。 - 每 5–10 秒
GET /v1/videos/{id}；生成和转存期间为pending/in_progress。 delivery_status变成ready后，播放地址在video.url，下载地址在video.download_url，均为本站域名，1 小时有效。- 超时不要重复创建，保留任务 id 继续查询。
注意事项
- 按秒计费：必须传 resolution 和时长，档位不在价格表里会直接返回 400。
- 参考素材必须是公网可访问的 HTTPS 直链，不支持 base64。
- 任务完成后视频链接从转存完成起 1 小时有效，请及时下载保存。
常见错误
| 返回 | 原因与处理 |
|---|---|
400 | 模型、时长或分辨率不在价格表里，按参数表检查 |
429 / 503 | 线路繁忙，稍后重试；不要重复创建同一任务 |
任务 failed | 查看返回的 error 字段；多为内容审核或素材不可访问，未成功的任务不扣费 |