简体中文

English

简体中文

English

主题

Grok Imagine Video ​

调用 提交 JSON 视频生成任务。

http
POST /v1/videos

当前可用模型 ​

请求头 ​

名称类型必填说明
string是请求身份认证。使用 Bearer Token，示例值：。
string是请求内容类型，必须设置为 。

请求体 ​

名称类型必填说明
string是模型名称，可选值见上方「当前可用模型」。
string是视频生成提示词。最多 个字符。
string否目标秒数。最小为 秒；建议按字符串传入，例如 。
string否宽高比。支持常见预设 、、、、、、、、、、、、，也支持 的自定义比例。
string否输出清晰度。支持 、，也兼容 、 写法。
string否单张参考图。使用 这类 data URI。
array<string>否多张参考图。数组成员使用 这类 data URI。传多张图时不要同时传 。

请求示例 ​

bash
curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '
{
  "model": "grok-imagine-video",
  "prompt": "清晨的城市街道，阳光穿过树叶，镜头缓慢向前移动",
  "seconds": "8",
  "aspect_ratio": "16:9",
  "resolution": "720P"
}'
bash
curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '
{
  "model": "grok-imagine-video",
  "prompt": "让参考图中的人物自然转身，背景保持柔和景深",
  "seconds": "6",
  "aspect_ratio": "9:16",
  "resolution": "720P",
  "image": "data:image/png;base64,BASE64_IMAGE_DATA"
}'
bash
curl -X POST https://octopusx.ai/v1/videos \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '
{
  "model": "grok-imagine-video",
  "prompt": "参考多张图片的主体特征，生成一段连贯的产品展示视频",
  "seconds": "10",
  "aspect_ratio": "16:9",
  "resolution": "720P",
  "images": [
    "data:image/png;base64,FIRST_IMAGE_BASE64",
    "data:image/png;base64,SECOND_IMAGE_BASE64"
  ]
}'

响应示例 ​

json
{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-imagine-video",
  "status": "queued",
  "progress": 0,
  "created_at": 1735689600,
  "seconds": "6",
  "size": "720P",
  "video_url": ""
}

响应字段 ​

名称类型说明
string任务 ID。后续可用于查询任务。
string对象类型，通常为 。
string实际提交的模型名。
string任务状态，常见值有 、、、、。
integer任务进度百分比。
string任务完成后的视频地址。也可以直接下载结果。

相关接口 ​