Vidu Q3 系列

POST

tasks

Vidu Q3 系列

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

import requests

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

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "generate_audio": True,
    "seed": 123
}
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>',
    image_urls: ['<string>'],
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    generate_audio: true,
    seed: 123
  })
};

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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"seed\": 123\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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"seed\": 123\n}")
  .asString();

生数科技 Vidu Q3 系列。本页覆盖 vidu-q3、vidu-q3-mix、vidu-q3-pro 和 vidu-q3-turbo：四个模型走同一个任务接口，都只有 generate 一个动作，都按分辨率档与秒数计费，区别在于要不要参考图、支持哪些分辨率档，以及能不能生成音频。前两个是参考生视频（image_urls 必填，人物与风格由参考图决定），后两个既能文生视频也能用首帧或首尾帧，并且默认带原生音频。需要 2k / 4k 输出、更多参考图（最多 15 张）或参考音频时，用 Vidu Q4 Preview；它不支持纯文生视频和首尾帧。

快速开始

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: vidu-demo-001" \
  -d '{
    "model": "vidu-q3",
    "action": "generate",
    "prompt": "保持角色形象，在森林中奔跑，镜头跟随",
    "image_urls": ["https://cdn.example.com/character.jpg"],
    "duration": 5,
    "resolution": "1080p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-q3-mix",
    "action": "generate",
    "prompt": "角色在这个场景里坐下，拿起桌上的杯子",
    "image_urls": [
      "https://cdn.example.com/character.jpg",
      "https://cdn.example.com/scene.jpg",
      "https://cdn.example.com/cup.jpg"
    ],
    "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" \
  -d '{
    "model": "vidu-q3-pro",
    "action": "generate",
    "prompt": "日出时分的海边天文台，镜头固定，海浪拍岸",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-q3-turbo",
    "action": "generate",
    "prompt": "镜头从室内缓缓推到窗外的街景",
    "image_urls": [
      "https://cdn.example.com/start.jpg",
      "https://cdn.example.com/end.jpg"
    ],
    "duration": 5,
    "resolution": "720p"
  }'

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

请求参数

string

必填

四选一：vidu-q3、vidu-q3-mix、vidu-q3-pro 或 vidu-q3-turbo。

string

默认值:"generate"

generate 是本页四个模型唯一的动作。生成模式不由 action 区分，而是看 image_urls 传了几张：vidu-q3-pro 与 vidu-q3-turbo 不传是文生视频，传 1 张是起始帧，传 2 张是首尾帧；vidu-q3 与 vidu-q3-mix 必须传参考图。

string

视频描述，写动作、镜头与氛围；带参考图时人物外观由参考图决定。vidu-q3 与 vidu-q3-mix 必填；vidu-q3-pro 与 vidu-q3-turbo 在不传 image_urls 时必填。

string[]

图片 URL 数组。

vidu-q3、vidu-q3-mix：参考图，必填，1–7 张，决定角色、主体、道具与风格
vidu-q3-pro、vidu-q3-turbo：可选，最多 2 张，1 张作起始帧、2 张作首尾帧

integer

视频时长（秒），整数。

vidu-q3：3 到 16
vidu-q3-mix：1 到 16
vidu-q3-pro、vidu-q3-turbo：1 到 16，默认 5

string

输出分辨率。

vidu-q3、vidu-q3-pro、vidu-q3-turbo：540p、720p 或 1080p
vidu-q3-mix：720p 或 1080p

四个模型默认都是 720p。

string

画面比例：16:9、9:16、4:3、3:4、1:1。vidu-q3、vidu-q3-pro 和 vidu-q3-turbo 不传时为 16:9。vidu-q3-pro 与 vidu-q3-turbo 带 image_urls 时不能传这个参数，画幅由输入图片决定。

boolean

默认值:"true"

是否生成音频（对白与音效）。只有 vidu-q3-pro 和 vidu-q3-turbo 接受，需要无声视频时设为 false。

integer

随机种子。同一组参数配同一个种子会得到接近的结果，不保证完全一致。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。本页四个模型都不接受 first_frame_image、last_frame_image（首尾帧用 image_urls 表达）、video_urls、audio_urls、n、negative_prompt 和 quality；generate_audio 只有 vidu-q3-pro 与 vidu-q3-turbo 接受。以上之外的参数会返回 400，不计费。

限制

模型	条件	限制
`vidu-q3` `vidu-q3-mix`	每次请求	本模型一次任务只产出一个结果，不支持用 n 批量生成
`vidu-q3` `vidu-q3-mix`	每次请求	必须提供 `image_urls`，最多 7 张
`vidu-q3-pro` `vidu-q3-turbo`	每次请求	每次任务只生成一个视频；最多 2 张图片（1 张起始帧，2 张首尾帧）。
`vidu-q3-pro` `vidu-q3-turbo`	传 `image_urls`	图生视频的画幅由输入图片决定，不能传 `aspect_ratio`。

计费

按分辨率档 × 秒数计费：分辨率决定每秒单价，duration 决定秒数，两者相乘就是这一单的费用，提交前即可确定。四个模型的每秒单价各不相同，同一个模型内分辨率越高越贵。 generate_audio、seed、画面比例、参考图张数都不影响价格。没带 resolution 时按默认档 720p 计费。

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

只有成功出片才计费。任务失败、取消，或没有返回可用视频时，全额退款。

响应

任务完成

{
  "task_id": "task-wave1788769966b950814242",
  "model": "vidu-q3-pro",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1788769966,
  "completed_at": 1788770002,
  "result": {
    "videos": [
      {
        "url": ["https://cdn.example.com/result.mp4"],
        "expires_at": 1789089508
      }
    ]
  },
  "billing_status": "settled",
  "cost": 31500,
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1788769966b950814242",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1788769966b950814242/cancel"
  }
}

result.videos 返回生成的视频，expires_at 是链接过期时间（Unix 秒），过期前把文件转存到自己的存储。完整字段说明见查询任务状态。

可用模型

模型 ID	分辨率	时长（秒）	图片输入	备注
`vidu-q3`	`540p` `720p` `1080p`	3–16	参考图 1–7 张，必填	参考生视频，保持参考主体一致，多镜头切换
`vidu-q3-mix`	`720p` `1080p`	1–16	参考图 1–7 张，必填	多张参考图融合成一段连贯视频
`vidu-q3-pro`	`540p` `720p` `1080p`	1–16	可选，最多 2 张	文生 / 起始帧 / 首尾帧，默认带音频
`vidu-q3-turbo`	`540p` `720p` `1080p`	1–16	可选，最多 2 张	与 Pro 同能力的加速档，单价更低

相关文档

Vidu Q3 系列

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

import requests

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

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "image_urls": ["<string>"],
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "generate_audio": True,
    "seed": 123
}
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>',
    image_urls: ['<string>'],
    duration: 123,
    resolution: '<string>',
    aspect_ratio: '<string>',
    generate_audio: true,
    seed: 123
  })
};

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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"seed\": 123\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  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"duration\": 123,\n  \"resolution\": \"<string>\",\n  \"aspect_ratio\": \"<string>\",\n  \"generate_audio\": true,\n  \"seed\": 123\n}")
  .asString();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

限制

计费

响应

可用模型

相关文档

​快速开始

​请求参数

​限制

​计费

​响应

​可用模型

​相关文档

快速开始

请求参数

限制

计费

响应

可用模型

相关文档