Veo 系列

POST

tasks

Veo 系列

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>",
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "negative_prompt": "<string>",
  "seed": 123,
  "generate_audio": true,
  "person_generation": "<string>",
  "resize_mode": "<string>",
  "image_urls": [
    "<string>"
  ],
  "generation_type": "<string>",
  "enable_gif": true,
  "ref_task_id": "<string>",
  "raw": true
}
'

import requests

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

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "negative_prompt": "<string>",
    "seed": 123,
    "generate_audio": True,
    "person_generation": "<string>",
    "resize_mode": "<string>",
    "image_urls": ["<string>"],
    "generation_type": "<string>",
    "enable_gif": True,
    "ref_task_id": "<string>",
    "raw": True
}
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>',
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    negative_prompt: '<string>',
    seed: 123,
    generate_audio: true,
    person_generation: '<string>',
    resize_mode: '<string>',
    image_urls: ['<string>'],
    generation_type: '<string>',
    enable_gif: true,
    ref_task_id: '<string>',
    raw: true
  })
};

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  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"seed\": 123,\n  \"generate_audio\": true,\n  \"person_generation\": \"<string>\",\n  \"resize_mode\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\",\n  \"enable_gif\": true,\n  \"ref_task_id\": \"<string>\",\n  \"raw\": true\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  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"seed\": 123,\n  \"generate_audio\": true,\n  \"person_generation\": \"<string>\",\n  \"resize_mode\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\",\n  \"enable_gif\": true,\n  \"ref_task_id\": \"<string>\",\n  \"raw\": true\n}")
  .asString();

Google Veo 3.1 的视频模型线，分两条线路。官方版 veo3.1-fast 与 veo3.1-quality 支持 4 / 6 / 8 秒、首尾帧、原生音频和 seed，按秒计费；经济版 veo3.1-lite、veo3.1-fast-rev、veo3.1-quality-rev 通过聚合供应商接入，固定输出 8 秒、按整片固定价计费，两个 -rev 档还能把自己生成的视频接着往下续写。其中 veo3.1-lite（Veo 3.1 Lite 经济版）属于经济版，不是 Google 官方版的 Veo 3.1 Lite。两条线路都提供 720p、1080p、4k 三档分辨率；参数集合与计费方式都不同，不会自动互相切换。

快速开始

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: veo-demo-001" \
  -d '{
    "model": "veo3.1-fast",
    "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" \
  -d '{
    "model": "veo3.1-quality",
    "action": "generate",
    "prompt": "人物从低头到抬头微笑，光线由暗转亮",
    "first_frame_image": "https://cdn.example.com/first.jpg",
    "last_frame_image": "https://cdn.example.com/last.jpg",
    "duration": 8,
    "resolution": "1080p",
    "resize_mode": "crop"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1-quality",
    "action": "generate",
    "prompt": "海浪拍打礁石，海鸥鸣叫，远处传来汽笛声",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "seed": 42
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1-lite",
    "action": "generate",
    "prompt": "夕阳下的海滨小镇，鸽群飞过钟楼",
    "duration": 8,
    "resolution": "720p",
    "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": "veo3.1-quality-rev",
    "action": "generate",
    "prompt": "镜头从街角推到店门口，霓虹逐渐亮起",
    "generation_type": "frame",
    "image_urls": [
      "https://cdn.example.com/first.jpg",
      "https://cdn.example.com/last.jpg"
    ],
    "duration": 8,
    "resolution": "1080p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1-fast-rev",
    "action": "generate",
    "prompt": "让这三张图里的角色、服装和场景出现在同一个镜头里",
    "generation_type": "reference",
    "image_urls": [
      "https://cdn.example.com/character.jpg",
      "https://cdn.example.com/outfit.jpg",
      "https://cdn.example.com/scene.jpg"
    ],
    "duration": 8,
    "resolution": "720p"
  }'

curl -X POST https://api.qingbo.ai/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1-fast-rev",
    "action": "extend",
    "ref_task_id": "task-wave1775285160b950328499",
    "prompt": "镜头继续向前，走进店内",
    "resolution": "720p",
    "raw": false
  }'

提交成功后返回 task_id。用 GET /v1/tasks/{task_id} 查询结果，也可以用 Prefer: wait 在一次调用里等待，或配置 Webhook。 接着往下做：续写分两步。先用 veo3.1-fast-rev 或 veo3.1-quality-rev 提交 action: "generate" 拿到 task_id；等这个任务 completed 之后，把它的 task_id 作为 ref_task_id 提交 action: "extend"。ref_task_id 用的是上一步任务返回的 task_id，不是上游 ID，且必须是同一个模型、同一个 API Key 下已完成的 generate 任务。续写默认输出 720p；要 4k 续写，父任务本身也必须是 4k。

请求参数

两条线路共用

string

必填

模型 ID，取值见「可用模型」。

string

默认值:"generate"

generate：生成视频，5 个模型都支持
extend：把已完成的视频接着往下续写，只有 veo3.1-fast-rev 与 veo3.1-quality-rev 支持；必须提供 ref_task_id

string

必填

视频描述；action: "extend" 时描述续写部分的内容。

integer

输出时长（秒），action: "generate" 时必填。官方版取 4、6 或 8，其中 resolution 为 1080p 或 4k 时只支持 8；经济版固定为 8。action: "extend" 不接受这个参数，续写时长由上游决定。

string

默认值:"720p"

输出分辨率：720p、1080p 或 4k。action: "extend" 时同样可传，默认 720p；4k 续写要求父任务也是 4k。

string

默认值:"16:9"

画面比例：16:9 或 9:16。

官方版（`veo3.1-fast` / `veo3.1-quality`）

string

首帧图 URL。

string

尾帧图 URL，必须与 first_frame_image 一起提供。

string

负面提示词，描述不希望出现的内容。

integer

随机种子，用于复现生成结果。

boolean

默认值:"false"

是否生成原生音频。开启后走带声档计费。

string

人物生成策略：allow_adult 允许生成成年人物 / disallow 不生成人物。

string

首尾帧与输出比例不一致时的处理方式：pad 补边 / crop 裁切。

经济版（`veo3.1-lite` / `veo3.1-fast-rev` / `veo3.1-quality-rev`）

string[]

参考图 URL 数组，veo3.1-fast-rev 与 veo3.1-quality-rev 支持，张数按 generation_type 而定。veo3.1-lite 是纯文生视频，不接受图片。

string

图片的用法，提供 image_urls 时必填：

frame：把图片当首帧 / 尾帧用，接受 1–2 张
reference：把图片当参考素材用，接受 1–3 张；只有 veo3.1-fast-rev 支持

boolean

默认值:"false"

额外输出一份 GIF。不能与 resolution 为 1080p 或 4k 同时使用。

string

必填

被续写的父任务 ID，action: "extend" 时必填。取上一步 generate 任务返回的 task_id。

boolean

默认值:"false"

action: "extend" 时是否只返回续写出来的那一段。false 返回拼接后的完整视频。

通用的 callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。官方版不接受 image_urls、generation_type、enable_gif、ref_task_id 和 raw；经济版不接受 first_frame_image、last_frame_image、negative_prompt、seed、generate_audio、person_generation 和 resize_mode。以上之外的参数会返回 400，不计费。

限制

模型	条件	限制
全部	`action: "generate"`	视频生成必须提供提示词和时长。
`veo3.1-fast`、`veo3.1-quality`	提供了 `last_frame_image`	尾帧必须与首帧一起提供。
`veo3.1-fast`、`veo3.1-quality`	`resolution` 为 `1080p` 或 `4k`	1080p 与 4K 仅支持 8 秒。
`veo3.1-fast-rev`、`veo3.1-quality-rev`	`action: "generate"`	经济版生成固定为 8 秒。
`veo3.1-fast-rev`、`veo3.1-quality-rev`	`action: "extend"`	续写只接受父任务、提示词、raw 与分辨率（默认 720p）；4K 续写要求父任务也是 4K。
`veo3.1-fast-rev`、`veo3.1-quality-rev`	提供了 `image_urls`	提供图片时必须声明 generation_type。
`veo3.1-fast-rev`、`veo3.1-quality-rev`	`generation_type: "frame"`	frame 模式接受一至两张图片。
`veo3.1-fast-rev`	`generation_type: "reference"`	reference 模式最多接受三张图片。
`veo3.1-lite`、`veo3.1-fast-rev`、`veo3.1-quality-rev`	`enable_gif: true` 且 `resolution` 为 `1080p` 或 `4k`	GIF 输出不能与 1080p 或 4K 同时使用。

项目	模型	上限
参考图张数	`veo3.1-fast-rev`	3 张
参考图张数	`veo3.1-quality-rev`	2 张
参考图张数	`veo3.1-lite`	不接受图片
首尾帧	`veo3.1-fast`、`veo3.1-quality`	首帧、尾帧各 1 张
时长	`veo3.1-fast`、`veo3.1-quality`	4 / 6 / 8 秒，最长 8 秒；`1080p`、`4k` 仅 8 秒
时长	`veo3.1-lite`、`veo3.1-fast-rev`、`veo3.1-quality-rev`	固定 8 秒

action: "extend" 的 ref_task_id 必须指向同一个模型下、状态已经是完成的 generate 任务；指向别的模型、别的动作或尚未完成的任务会返回 400，不计费。

计费

官方版

veo3.1-fast 与 veo3.1-quality 按分辨率档 × 秒数计费：resolution 决定档位（720p / 1080p / 4k），秒数取请求里的 duration（4、6 或 8；1080p、4k 只有 8）。 generate_audio: true 时换成带声档的每秒单价，仍然只乘 duration。三个分辨率都有带声档。首尾帧、negative_prompt、seed 不影响价格。

经济版

veo3.1-lite、veo3.1-fast-rev、veo3.1-quality-rev 按整片固定价计费：一次生成一次收费，与时长无关（输出固定 8 秒），分辨率是唯一的分档维度，参考图张数与 generation_type 不影响价格。 action: "extend" 同样按整片固定价计一次费用，与续写出来的长度无关，档位取请求里的 resolution（不传按 720p）；raw 取 true 或 false 不影响价格。

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

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

响应

任务完成

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo3.1-fast",
  "action": "generate",
  "status": "completed",
  "progress": "100%",
  "created_at": 1775285160,
  "completed_at": 1775285412,
  "result": {
    "videos": [
      {
        "url": ["https://cdn.example.com/result.mp4"],
        "expires_at": 1775621160
      }
    ]
  },
  "urls": {
    "get": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499",
    "cancel": "https://api.qingbo.ai/v1/tasks/task-wave1775285160b950328499/cancel"
  },
  "billing_status": "settled",
  "cost": 288000
}

result.videos 返回生成的视频，expires_at 是链接失效时间，到期前请自行转存。完整字段说明见查询任务状态。

可用模型

官方版 —— 按秒计费，支持首尾帧与原生音频。

模型 ID	时长	分辨率	图片输入	原生音频
`veo3.1-fast`	4 / 6 / 8 秒	`720p` `1080p` `4k`（1080p、4k 仅 8 秒）	首帧 + 尾帧	支持
`veo3.1-quality`	4 / 6 / 8 秒	`720p` `1080p` `4k`（1080p、4k 仅 8 秒）	首帧 + 尾帧	支持

经济版 —— 整片固定价，固定输出 8 秒，不支持原生音频。

模型 ID	动作	分辨率	图片输入	GIF
`veo3.1-lite`	`generate`	`720p` `1080p` `4k`	不接受	`enable_gif`（仅 720p）
`veo3.1-fast-rev`	`generate` `extend`	`720p` `1080p` `4k`	`frame` 1–2 张 / `reference` 1–3 张	`enable_gif`（仅 720p）
`veo3.1-quality-rev`	`generate` `extend`	`720p` `1080p` `4k`	`frame` 1–2 张	`enable_gif`（仅 720p）

相关文档

Veo 系列

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>",
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "negative_prompt": "<string>",
  "seed": 123,
  "generate_audio": true,
  "person_generation": "<string>",
  "resize_mode": "<string>",
  "image_urls": [
    "<string>"
  ],
  "generation_type": "<string>",
  "enable_gif": true,
  "ref_task_id": "<string>",
  "raw": true
}
'

import requests

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

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "duration": 123,
    "resolution": "<string>",
    "aspect_ratio": "<string>",
    "first_frame_image": "<string>",
    "last_frame_image": "<string>",
    "negative_prompt": "<string>",
    "seed": 123,
    "generate_audio": True,
    "person_generation": "<string>",
    "resize_mode": "<string>",
    "image_urls": ["<string>"],
    "generation_type": "<string>",
    "enable_gif": True,
    "ref_task_id": "<string>",
    "raw": True
}
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>',
    first_frame_image: '<string>',
    last_frame_image: '<string>',
    negative_prompt: '<string>',
    seed: 123,
    generate_audio: true,
    person_generation: '<string>',
    resize_mode: '<string>',
    image_urls: ['<string>'],
    generation_type: '<string>',
    enable_gif: true,
    ref_task_id: '<string>',
    raw: true
  })
};

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  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"seed\": 123,\n  \"generate_audio\": true,\n  \"person_generation\": \"<string>\",\n  \"resize_mode\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\",\n  \"enable_gif\": true,\n  \"ref_task_id\": \"<string>\",\n  \"raw\": true\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  \"first_frame_image\": \"<string>\",\n  \"last_frame_image\": \"<string>\",\n  \"negative_prompt\": \"<string>\",\n  \"seed\": 123,\n  \"generate_audio\": true,\n  \"person_generation\": \"<string>\",\n  \"resize_mode\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"generation_type\": \"<string>\",\n  \"enable_gif\": true,\n  \"ref_task_id\": \"<string>\",\n  \"raw\": true\n}")
  .asString();

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

账户与用量

快速开始

请求参数

两条线路共用

官方版（`veo3.1-fast` / `veo3.1-quality`）

经济版（`veo3.1-lite` / `veo3.1-fast-rev` / `veo3.1-quality-rev`）

限制

计费

官方版

经济版

响应

可用模型

相关文档

​快速开始

​请求参数

​两条线路共用

​官方版（veo3.1-fast / veo3.1-quality）

​经济版（veo3.1-lite / veo3.1-fast-rev / veo3.1-quality-rev）

​限制

​计费

​官方版

​经济版

​响应

​可用模型

​相关文档

快速开始

请求参数

两条线路共用

官方版（`veo3.1-fast` / `veo3.1-quality`）

经济版（`veo3.1-lite` / `veo3.1-fast-rev` / `veo3.1-quality-rev`）

限制

计费

官方版

经济版

响应

可用模型

相关文档