xAI
视频生成
使用 CometAPI 的 POST /grok/v1/videos/generations 通过 Grok 创建视频，通过 prompt 让输入图片动起来，并通过 request_id 轮询结果。
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}使用此端点可以通过文本，或文本加一张源图片，启动一个 Grok 视频任务。它会立即返回一个
request_id，因此应将其视为异步工作流的第一步。
从小请求开始
- 使用
model: grok-imagine-video - 对于冒烟测试，将
duration保持为1，resolution保持为480p - 仅当你需要图生视频时才添加
image.url - 如果你发送 base64，请将文档和 OpenAPI 示例中的格式保持为
data:image/png;base64,<BASE64_IMAGE_DATA>
任务流程
轮询直到完成
调用 获取视频生成结果，直到嵌套的 provider 状态变为
done。CometAPI 上有哪些变化
xAI 将视频生成记录为一个两步式的启动 -> 轮询流程。CometAPI 保持相同的请求结构和相同的核心模型 id，但你需要使用 CometAPI key 进行认证，并且继续使用 CometAPI 的 base URL。一个真实的 1 秒 480p 请求已于 2026-03-12 成功完成，并返回了一个真实的结果 URL。授权
Bearer token authentication. Use your CometAPI key.
请求体
application/json
Prompt for the video job.
示例:
"A candle flickers on a wooden table."
Output aspect ratio.
可用选项:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
示例:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
可用选项:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
响应
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}