视频系列Grok 视频
Grok 视频生成
使用 /v1/videos 提交 Grok 视频生成任务，并通过任务 ID 查询结果。
Grok 视频生成走 OpenAI 兼容的 /v1/videos 异步任务接口。提交成功后保存返回的 id，再通过 GET /v1/videos/{task_id} 查询进度和 video_url。
| 能力 | 接口 |
|---|---|
| 创建任务 | POST /v1/videos |
| 查询任务 | GET /v1/videos/{task_id} |
| 支持模型 | grok-imagine-video, grok-imagine-video-1.5-preview |
创建视频
curl -X POST "$MODELSELL_BASE_URL/v1/videos" \
-H "Authorization: Bearer $MODELSELL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "这里显示请求将发送的提示词",
"seconds": "6",
"resolution": "720p",
"aspect_ratio": "16:9",
"custom_domain": "true",
"reference_images": [
{
"url": "http://38.145.220.6:9000/preview/reference.png"
}
],
"video": {
"url": "http://38.145.220.6:9000/preview/reference.mp4"
}
}'请求体使用 application/json。reference_images 用于传入参考图片 URL，video.url 用于传入参考视频 URL；不需要某类参考素材时可省略对应字段。
响应会返回异步任务对象：
{
"id": "video_55c77134-3fbe-4d5d-839f-c9af4556405b",
"object": "video",
"model": "grok-imagine-video",
"status": "queued",
"progress": 0,
"created_at": 1762600200,
"seconds": "6",
"size": "720p"
}查询结果
curl "$MODELSELL_BASE_URL/v1/videos/video_55c77134-3fbe-4d5d-839f-c9af4556405b" \
-H "Authorization: Bearer $MODELSELL_API_KEY"生成完成后读取 video_url：
{
"id": "video_55c77134-3fbe-4d5d-839f-c9af4556405b",
"object": "video",
"model": "grok-imagine-video",
"status": "completed",
"progress": 100,
"created_at": 1762600200,
"completed_at": 1762600260,
"expires_at": 1762686660,
"seconds": "6",
"size": "720p",
"remixed_from_video_id": "",
"error": null,
"video_url": "https://example.com/result.mp4"
}建议客户端按固定间隔轮询。status 为失败状态时读取 error.message 和 error.code，生成成功后及时下载或转存 video_url。