跳到主要内容

xAI Grok Video 1.5 · POST /v1/video/generations · 视频生成

POST 
/v1/video/generations

基本信息​

  • Base URL：https://api.dshub.top
  • 端点：POST /v1/video/generations
  • Content-Type：application/json
  • 用途：xAI Grok Video 1.5 兼容视频生成入口。对外模型名保持 grok-video-1.5，服务端会按参考图数量自动适配上游文生、单图和多参考图模式。

推荐模型​

场景model图片要求时长
兼容视频生成grok-video-1.5参考图可选，最多 7 张seconds 可传 4、6、8、10、12、15；多参考图实际最长 10 秒
6 秒别名grok-video-1.5-4s/6s参考图可选，最多 7 张固定按 6 秒提交
10 秒别名grok-video-1.5-8s/10s参考图可选，最多 7 张固定按 10 秒提交
15 秒别名grok-video-1.5-15s参考图可选，最多 7 张单图最长 15 秒；多参考图会按 10 秒参考模式提交

grok-video-1.5-* 是本站公开时长/路由别名。用户侧不需要改模型名；内部 Adapter 会在无图/多图时使用上游通用模型，在单图时保持单图模型。

参数校验​

  • model：必填，只接受文档枚举值。
  • prompt：必填，非空字符串，最多 4096 字符。
  • image_urls：可选数组，最多 7 张参考图 URL；不传图走文生视频，1 张图走单图生视频，2～7 张图走多参考图模式。
  • 兼容字段：image_url、image、images、image_urls、input_reference、reference_images；服务端会统一收集并去重，内部再转换为上游所需字段。
  • input_reference 可传字符串、最多 7 张 URL 数组，或 { "image_url": "..." } / { "url": "..." } 等对象；reference_images 可用于显式多参考图。
  • seconds / duration：可选，只能传 4、6、8、10、12、15 秒；时长别名会覆盖该字段。
  • 多参考图模式实际最长 10 秒；如果传 12 或 15 秒，服务端会按 10 秒提交。
  • resolution：可选，枚举 720p、480p，默认 720p。
  • aspect_ratio：可选，枚举 16:9、9:16，默认 16:9。

返回与轮询​

提交成功后返回 id / task_id。使用 GET /v1/video/generations/{task_id} 或通用 GET /v1/videos/{task_id} 轮询。

cURL：Grok Video 1.5 文生视频​

curl --location --request POST 'https://api.dshub.top/v1/video/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "grok-video-1.5",
    "prompt": "一辆红色跑车在雨夜霓虹街道中穿行，电影感镜头，湿润路面反光",
    "seconds": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

cURL：Grok Video 1.5 单图生视频​

curl --location --request POST 'https://api.dshub.top/v1/video/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "grok-video-1.5",
    "prompt": "让产品图产生缓慢、稳定的电影感运镜，保持主体结构不变",
    "image_urls": ["https://example.com/product.png"],
    "seconds": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

cURL：Grok Video 1.5 多参考图​

curl --location --request POST 'https://api.dshub.top/v1/video/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "grok-video-1.5",
    "prompt": "使用这些参考图生成一个平滑的高端产品展示视频，干净背景，柔和商业灯光",
    "image_urls": [
      "https://example.com/ref-1.png",
      "https://example.com/ref-2.png"
    ],
    "seconds": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

cURL：15 秒别名​

curl --location --request POST 'https://api.dshub.top/v1/video/generations' \
  --header 'Authorization: Bearer sk-xxx' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "grok-video-1.5-15s",
    "prompt": "让人物照片产生自然呼吸感和轻微镜头推进",
    "image_url": "https://example.com/portrait.png",
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'

Request​

Responses​

提交成功

Response Headers