跳转到主要内容
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

使用此端点可通过文本，或通过文本加一张源图像来启动一个 Grok 视频任务。它会立即返回一个 request_id，因此请将其视为异步工作流中的第一步。

​
从小请求开始

  • 使用 model: grok-imagine-video
  • 首次请求时，将 duration 保持为 1，并将 resolution 保持为 480p
  • 仅当你希望进行图生视频时才添加 image.url
  • 如果你发送 base64，请将文档和 OpenAPI 示例格式保持为 data:image/png;base64,<BASE64_IMAGE_DATA>

​
任务流程

1

创建任务

发送 prompt，并保存返回的 request_id。
2

轮询完成状态

调用 获取视频生成结果，直到嵌套的 provider 状态变为 done。
3

持久化输出

如果你需要在 provider 的临时交付窗口结束后继续使用它，请将最终的 video.url 复制到你自己的存储中。

授权

​
Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求体

application/json
​
prompt
string
必填

Prompt for the video job.

示例:

"A candle flickers on a wooden table."

​
aspect_ratio
enum<string>

Output aspect ratio.

可用选项:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
默认值:1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

​
image
object

Optional source image for image-to-video.

​
model
string
默认值:grok-imagine-video

xAI video model id.

示例:

"grok-imagine-video"

​
output
object
​
resolution
enum<string>

Output resolution.

可用选项:
480p,
720p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

响应

200 - application/json

Request accepted.

​
request_id
string
必填

Deferred request id used for polling.