跳转到主要内容
POST
/
v1
/
tasks
Grok Imagine Video 系列
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "grok-imagine-1.0-video",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

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

xAI Grok Imagine 1.0 视频生成模型,Grok 多模态家族中的视频档。 字段简洁、参数门槛低,适合社交媒体短视频、快速概念演示、低成本内容生产线。
Grok Imagine 系列分图像档与视频档两条线。图像生成请见 Grok Imagine 图像;本页只覆盖视频档。

​
定价

按视频时长计费,全分辨率统一单价:$0.0074375 / 秒。
时长单次费用
5 秒$0.037
10 秒$0.074
30 秒(上限)$0.223

​
调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.0-video",
    "prompt": "霓虹灯下的雨夜街道,赛博朋克氛围,镜头缓慢推进",
    "duration": 6,
    "aspect_ratio": "16:9",
    "resolution": "480p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "grok-imagine-1.0-video",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
提交后用 GET /v1/tasks/{task_id} 轮询状态,详见 任务系统。

​
可用模型

模型 ID说明
grok-imagine-1.0-videoxAI Grok Imagine 1.0 视频档,T2V / I2V,5 种比例,480p / 720p,6-30 秒

​
通用参数

​
model
string
必填
固定为 grok-imagine-1.0-video
​
action
string
默认值:"generate"
操作类型,可选值:
  • generate — 文生视频(T2V)
  • image2video — 图生视频(I2V),需配合 image_urls
​
prompt
string
必填
视频描述文本。T2V 模式必填;I2V 模式可作为运动 / 风格引导
​
aspect_ratio
string
默认值:"16:9"
画面宽高比,仅 T2V 生效;I2V 模式自动跟随参考图比例。可选值:
  • 16:9 — 横版宽屏
  • 9:16 — 竖版长屏
  • 1:1 — 正方形
  • 3:2 — 横版
  • 2:3 — 竖版
​
resolution
string
默认值:"480p"
输出分辨率,可选值:
  • 480p
  • 720p
​
duration
integer
默认值:"6"
视频时长(秒),范围 6-30 任意整数。注意:30 秒为上限,跟其他常见 video model(多为 5/10/15)不同
​
image_urls
string[]
参考图片 URL 数组,最多 7 张。传入即触发 I2V 模式,系统会自动匹配参考图的宽高比
​
callback_url
string
Webhook 回调地址,任务终态时调用。详见 回调机制
​
callback_events
string[]
回调事件订阅列表,默认仅终态推送

​
注意事项

  • 图生模式比例自动匹配 — 传入 image_urls 后,aspect_ratio 字段会被忽略,输出比例跟随首张参考图。
  • duration 范围特殊 — 6-30 秒,跟仓内多数 video model(5/10/15 三档)不同,业务侧表单做枚举校验时记得放开整段区间。
  • 可用性受上游影响 — 上游 xAI / Grok 配额可能波动,建议生产环境配 callback_url 异步推送、不要纯轮询。

​
资源限制

项目限制
参考图片最多 7 张,JPG/PNG/WEBP
时长6-30 秒
分辨率480p / 720p
输出MP4,链接 24 小时有效

​
相关文档