视频生成系列
Grok Video 1.5 Preview
Grok Video 1.5 Preview 视频生成,将 1 张参考图生成 10 秒或 15 秒视频。
CokeAPI 接入 Grok Video 1.5 Preview 视频模型。默认是异步任务: POST 创建后拿到 task_id,再通过 GET /v1/generations/{task_id} 轮询直到 completed。
图生视频提示:该模型仅支持图生视频,不支持文生视频。请先使用 文件上传接口 上传参考图片获取 URL,再传入 images。
限制说明:
- 必须传入且仅能传入 1 张公网参考图 URL
- 支持
10秒和15秒视频 - 画面比例仅支持
16:9和9:16
模型 ID: grok-video-1.5-preview
调用示例
查询任务状态
使用创建任务返回的 id 调用异步任务接口查询状态:
curl https://cokeapi.com/v1/generations/{task_id} \
-H "Authorization: Bearer sk-xxxxxxxx"请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| model | string | 是 | grok-video-1.5-preview | 模型 ID |
| prompt | string | 是 | — | 描述参考图需要生成的动态效果、镜头运动和视觉方向 |
| images | string[] | 是 | — | 传入且仅传入 1 个公网图片 URL (最少 1 个,最多 1 个) |
| seconds | string | 否 | "10" | 视频时长,支持值: "10" 或 "15" |
| aspect_ratio | string | 否 | 16:9 | 视频画面比例,支持值: 16:9 或 9:16 |
响应
创建任务 (POST)
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"model": "grok-video-1.5-preview",
"status": "queued",
"progress": 0,
"created": 1768380224,
"kind": "video",
"mode": "image_to_video"
}查询任务 (GET /v1/generations/{task_id})
进行中:
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"model": "grok-video-1.5-preview",
"status": "running",
"progress": 45,
"created": 1768380224,
"kind": "video",
"mode": "image_to_video"
}完成后:
{
"id": "video_abc123def456",
"task_id": "video_abc123def456",
"object": "video.generation.task",
"model": "grok-video-1.5-preview",
"status": "succeeded",
"progress": 100,
"created": 1768380224,
"kind": "video",
"mode": "image_to_video",
"result": {
"id": "video_abc123def456",
"object": "video.generation",
"created": 1768380224,
"model": "grok-video-1.5-preview",
"data": [
{
"url": "https://cdn.cokeapi.com/v/video_abc123def456.mp4",
"duration_ms": 10000,
"width": 1920,
"height": 1080
}
]
}
}任务状态说明
| 状态 | 说明 |
|---|---|
| queued | 任务已排队等待处理 |
| running | 任务正在处理中 |
| succeeded | 任务已完成 |
| failed | 任务失败 |
| refunded | 任务失败已退款 |
计费
按 6 秒基准档计费,超过 6 秒按 10 秒档计费(费用 = 基准价 × 10/6)。
| 分辨率 | 6 秒基准价 | 10 秒价 |
|---|---|---|
| 480p | $0.24 | $0.4 |
实际可选时长为 10 秒或 15 秒,均按 10 秒档计费。
失败任务不计费,自动退款。价格为 2026-07 快照,以 模型列表页 实时价目为准。
注意事项
- 仅支持图生视频,不支持文生视频
- 必须传入且仅能传入 1 张公网参考图 URL
- 不要直接传入 base64 图片数据,请先使用上传接口
- 支持
10秒和15秒视频 - 画面比例仅支持
16:9和9:16 - 任务最长保留 24 小时,超过会被清理
- 失败的任务不计费