Grok Imagine Video 系列

POST

tasks

curl --request POST \
  --url https://api.qingbo.ai/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "image_urls": [
    "<string>"
  ],
  "video_urls": [
    "<string>"
  ]
}
'

import requests

url = "https://api.qingbo.ai/v1/tasks"

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "image_urls": ["<string>"],
    "video_urls": ["<string>"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    action: '<string>',
    prompt: '<string>',
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    image_urls: ['<string>'],
    video_urls: ['<string>']
  })
};

fetch('https://api.qingbo.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qingbo.ai/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.qingbo.ai/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ]\n}")
  .asString();

xAI 的 Grok Imagine 视频线，共三个模型 ID。官方版 grok-imagine-video-1.5 最高 1080p、时长从 1 秒起，可传多张参考图；官方版 grok-imagine-video 支持 480p / 720p 生成，另有视频编辑动作 edit；经济版 grok-imagine-video-1.5-rev 只有 480p / 720p、时长从 6 秒起，最多 7 张参考图且不加价。图像生成见 Grok Imagine 系列。

快速开始

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-video-001" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "action": "generate",
    "prompt": "极光下的雪原，镜头缓慢横移，无文字",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-video-i2v-001" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "action": "generate",
    "prompt": "第一张图的人物穿着第二张图的外套，缓缓转头看向镜头",
    "image_urls": [
      "https://cdn.example.com/portrait.jpg",
      "https://cdn.example.com/coat.jpg"
    ],
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "9:16"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "action": "edit",
    "prompt": "把画面改成水彩风格，人物动作保持不变",
    "video_urls": ["https://cdn.example.com/source.mp4"]
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5-rev",
    "action": "generate",
    "prompt": "保持角色一致，在森林中奔跑",
    "image_urls": [
      "https://cdn.example.com/ref-1.jpg",
      "https://cdn.example.com/ref-2.jpg",
      "https://cdn.example.com/ref-3.jpg"
    ],
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。

请求参数

string

必填

三选一，取值见可用模型。

string

默认值:"generate"

generate：文生视频或图生视频，三个模型都支持；传 image_urls 即为图生视频
edit：视频编辑，只有 grok-imagine-video 支持；必须提供 video_urls

string

必填

视频内容描述或编辑指令，中英文均可。

integer

输出时长（秒），整数，action: "generate" 时必填。grok-imagine-video 和 grok-imagine-video-1.5 取 1–15；grok-imagine-video-1.5-rev 取 6–15。action: "edit" 不传或传 0，输出时长跟随源视频。

string

默认值:"480p"

输出分辨率。grok-imagine-video-1.5 支持 480p、720p、1080p；其余两个模型支持 480p 和 720p。action: "edit" 不生效，输出沿用源视频分辨率（最高 720p）。

string

画面比例，取值集合按模型不同，见可用模型。grok-imagine-video-1.5 默认 auto，带参考图时必须指定具体比例；grok-imagine-video 和 grok-imagine-video-1.5-rev 默认 16:9。action: "edit" 不生效，沿用源视频画幅。

string[]

参考图 URL 数组，需公网可访问，只用于 action: "generate"。grok-imagine-video 与 grok-imagine-video-1.5 可传多张；grok-imagine-video-1.5-rev 最多 7 张。

string[]

源视频 URL 数组，只有 grok-imagine-video 的 action: "edit" 接受；1 条，最长 8.7 秒。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。 n 不支持，一次任务只出一个结果。seed、generate_audio 和 audio_urls 不支持。以上之外的参数会返回 400，不计费。

限制

模型	条件	限制
`grok-imagine-video`	每次请求	本模型一次任务只产出一个结果，不支持用 n 批量生成
`grok-imagine-video`	`action: "generate"`	generate 不接受源视频；编辑视频请用 edit。
`grok-imagine-video`	`action: "edit"`	视频编辑需要且只接受一条源视频（最长 8.7 秒），不接受参考图。输出沿用源视频的时长、画幅和分辨率（最高 720p），因此不能指定 duration（不传或传 0），resolution / aspect_ratio 不生效。
`grok-imagine-video-1.5`	每次请求	视频接口不支持 n。
`grok-imagine-video-1.5`	素材输入	该组不接收视频或音频输入。
`grok-imagine-video-1.5`	音频生成	供应商未公开音频控制参数。
`grok-imagine-video-1.5`	提供了 `image_urls`	带参考图时需要指定具体画幅比例（1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3），不支持 auto。
`grok-imagine-video-1.5-rev`	每次请求	视频接口不支持 n。
`grok-imagine-video-1.5-rev`	素材输入	该组不接收视频或音频输入。
`grok-imagine-video-1.5-rev`	音频生成	供应商未公开音频控制参数。

计费

按分辨率档 × 秒数计费，每个分辨率档有各自的每秒价。

模型 · 动作	计费维度
`grok-imagine-video` · `generate`	`480p` / `720p` 每秒价 × 输出秒数；参考图按张另计
`grok-imagine-video` · `edit`	编辑档每秒价 × 实际输出秒数 + 源视频每秒价 × 源视频秒数
`grok-imagine-video-1.5` · `generate`	`480p` / `720p` / `1080p` 每秒价 × `duration`；参考图按张另计
`grok-imagine-video-1.5-rev` · `generate`	`480p` / `720p` 每秒价 × `duration`；参考图不加价

grok-imagine-video 提交时冻结额度（edit 按时长上限冻结），完成后按实际生成结果结算退差。

各模型的单价见 GET /v1/models 返回的 price_config，或控制台「模型市场」。看这一单实际花了多少：任务响应里的 cost（整数 quota，500,000 quota = 1 USD）。

只有成功出片才计费。任务失败、取消，或没有返回可用视频时，全额退款。最终费用以任务响应里的 cost 为准，它是整数 quota 不是美元。

响应

任务完成

{
  "task_id": "task-wave1775285160b950328499",
  "model": "grok-imagine-video-1.5-rev",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1775285160,
  "completed_at": 1775285352,
  "billing_status": "settled",
  "cost": 64530,
  "result": {
    "videos": [
      {
        "expires_at": 1775371560,
        "url": ["https://cdn.example.com/result.mp4"]
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  }
}

result.videos 返回生成的视频，每次任务一条。视频链接有有效期，取到后尽快转存。完整字段说明见查询任务状态。

可用模型

模型 ID	动作	分辨率	时长（秒）	参考图
`grok-imagine-video`	`generate` `edit`	`480p` `720p`	1–15；`edit` 跟随源视频	可传多张，按张另计
`grok-imagine-video-1.5`	`generate`	`480p` `720p` `1080p`	1–15	可传多张，按张另计
`grok-imagine-video-1.5-rev`	`generate`	`480p` `720p`	6–15	最多 7 张，不加价

画幅取值集合：

grok-imagine-video-1.5：auto、1:1、16:9、9:16、4:3、3:4、3:2、2:3（带参考图时不能用 auto）
grok-imagine-video：1:1、16:9、9:16、4:3、3:4、3:2、2:3
grok-imagine-video-1.5-rev：16:9、9:16、1:1、3:2、2:3

与官方线路的区别

经济版和官方版共用同一个任务接口、同一套参数名，差别集中在四处：

分辨率：1080p 只有 grok-imagine-video-1.5 有，经济版最高 720p。
时长：官方两个模型从 1 秒起，经济版从 6 秒起，上限都是 15 秒。
参考图：官方两个模型按张另计；grok-imagine-video-1.5-rev 最多 7 张，不加价。
视频编辑：只有 grok-imagine-video 支持 action: "edit"。

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

Grok Imagine Video 系列

快速开始

请求参数

限制

计费

响应

可用模型

与官方线路的区别

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​可用模型

​与官方线路的区别

​相关文档

快速开始

请求参数

限制

计费

响应

可用模型

与官方线路的区别

相关文档