万相 Wan 系列 - QWave API

POST

tasks

万相 Wan 系列

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

import requests

url = "https://www.qingbo.dev/v1/tasks"

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

fetch('https://www.qingbo.dev/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://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\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://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ]\n}")
  .asString();

{
  "task_id": "task-wave1775285160b950328499",
  "model": "wan2.7",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

阿里巴巴通义万相(Wan)视频生成系列,覆盖 文生视频 / 图生视频 / 参考生视频 / 视频编辑 四类场景,统一走异步任务入口。五个档位:

wan2.7 — 最新主力档,文生 / 图生统一入口(传 image_urls 自动进图生模式,首帧 / 首尾帧),720P / 1080P,2-15 秒任意整数,支持负面提示词与智能扩写
wan2.6 — 经典稳定档,文生 / 图生,480p / 720p / 1080p,5 / 10 / 15 秒
wan2.5-preview — 2.5 预览档,文生 / 图生(传 image_urls 自动进图生模式),480p / 720p / 1080p,5 / 10 秒,价位更亲民
wan2.7-r2v — 参考生视频(R2V),以一张或多张参考图作主体 / 风格参考生成新视频,角色一致性 / 风格延续,需传 image_urls
wan2.7-videoedit — 视频编辑,输入源视频 + 文本指令实现风格迁移 / 内容替换 / 整段改写,需传 video_urls

全系 按秒计费:实际费用 = 对应分辨率单价 × 时长(秒)。下表为各分辨率每秒售价(已含优惠)。

定价

模型	480P/p	720P/p	1080P/p
`wan2.7`	—	`$0.0747` / 秒	`$0.1233` / 秒
`wan2.6`	`$0.05625` / 秒	`$0.05625` / 秒	`$0.0945` / 秒
`wan2.5-preview`	`$0.0378` / 秒	`$0.0747` / 秒	`$0.1233` / 秒
`wan2.7-r2v`	—	`$0.0747` / 秒	`$0.1233` / 秒
`wan2.7-videoedit`	—	`$0.0747` / 秒	`$0.1233` / 秒

实际扣费 = 每秒单价 × duration。例:wan2.7 1080P 生成 8 秒 = 0.1233 × 8 = $0.9864。wan2.7-videoedit 按用户指定的输出时长结算。

调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7",
    "prompt": "夕阳下的海边公路,慢镜头推进,电影感画面",
    "duration": 8,
    "resolution": "1080P",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7",
    "prompt": "人物缓缓站起身,向镜头走来",
    "image_urls": ["https://cdn.example.com/person.jpg"],
    "duration": 8,
    "resolution": "1080P"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.6",
    "prompt": "一只可爱的猫咪在草地上奔跑",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-preview",
    "prompt": "画面中的人物缓缓抬头望向天空",
    "image_urls": ["https://cdn.example.com/portrait.jpg"],
    "duration": 5,
    "resolution": "720p"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-r2v",
    "prompt": "保持角色形象,在森林中奔跑,镜头跟随",
    "image_urls": [
      "https://cdn.example.com/char-1.jpg",
      "https://cdn.example.com/char-2.jpg"
    ],
    "duration": 8,
    "resolution": "1080P",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-videoedit",
    "prompt": "把场景改为雪天,保留人物动作",
    "video_urls": ["https://cdn.example.com/source.mp4"],
    "duration": 8,
    "resolution": "1080P"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "wan2.7",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

提交后用 GET /v1/tasks/{task_id} 轮询状态,详见任务系统。

可用模型

模型 ID	分辨率	时长	宽高比	必传	备注
`wan2.7`	720P / 1080P	2-15 秒任意整数	16:9 / 9:16 / 1:1 / 4:3 / 3:4	`prompt`	文生 / 图生统一入口,传 `image_urls` 进图生
`wan2.6`	480p / 720p / 1080p	5 / 10 / 15 秒	16:9 / 9:16 / 1:1	`prompt`	经典稳定档,文生 / 图生
`wan2.5-preview`	480p / 720p / 1080p	5 / 10 秒	16:9 / 9:16 / 1:1	`prompt`	2.5 预览档,文生 / 图生,传 `image_urls` 进图生
`wan2.7-r2v`	720P / 1080P	2-15 秒任意整数	16:9 / 9:16 / 1:1	`prompt` + `image_urls`	参考生视频,角色 / 风格一致性
`wan2.7-videoedit`	720P / 1080P	2-15 秒任意整数	16:9 / 9:16 / 1:1	`prompt` + `video_urls`	视频编辑,风格迁移 / 内容替换

分辨率大小写按模型区分:wan2.7 / wan2.7-r2v / wan2.7-videoedit 用大写 720P / 1080P,wan2.6 / wan2.5-preview 用小写 480p / 720p / 1080p。

通用参数

model

string

必填

模型 ID,见可用模型表

prompt

string

必填

视频内容描述。文生模式必填;图生 / 参考生 / 编辑模式可选,但建议填写以指导运镜与动作。最多 5000 字符

image_urls

string[]

参考 / 输入图片 URL 数组:

wan2.7:传入后进入图生模式 —— 1 张为首帧,2 张为首尾帧
wan2.6:仅支持 1 张,传入后进入图生模式
wan2.5-preview:传入后进入图生模式(图生视频)
wan2.7-r2v:必传,作为主体 / 风格参考(R2V)
wan2.7-videoedit:可选,叠加风格 / 内容参考图,最多 4 张

video_urls

string[]

源视频 URL 数组(单元素)。wan2.7-videoedit 必传;暂不支持 base64,需公网可下载链接

resolution

string

输出分辨率,各模型档位见可用模型表:

wan2.7 / wan2.7-r2v / wan2.7-videoedit:720P / 1080P(默认 1080P)
wan2.6 / wan2.5-preview:480p / 720p / 1080p(默认 720p)

duration

integer

视频时长(秒):

wan2.7 / wan2.7-r2v / wan2.7-videoedit:2-15 任意整数(默认 5)
wan2.6:仅 5 / 10 / 15(默认 5)
wan2.5-preview:仅 5 / 10(默认 5)

wan2.7-videoedit 按用户指定的输出时长结算。

aspect_ratio

string

默认值:"16:9"

画面宽高比(图生模式下由输入图片自动决定,此参数会被忽略):

wan2.7:16:9 / 9:16 / 1:1 / 4:3 / 3:4
wan2.6 / wan2.5-preview / wan2.7-r2v / wan2.7-videoedit:16:9 / 9:16 / 1:1

seed

integer

随机种子(≥0)。相同请求 + 相同 seed 会生成相似结果,不指定则每次不同

callback_url

string

Webhook 回调地址,任务终态时调用。详见回调机制

callback_events

string[]

订阅的回调事件,默认订阅终态(succeeded / failed / cancelled)

模型特定参数

wan2.7
wan2.6
wan2.5-preview
wan2.7-r2v
wan2.7-videoedit

prompt_extend

boolean

默认值:"true"

提示词智能扩写,对较短提示词效果提升明显,但会增加耗时

negative_prompt

string

负面提示词,描述不希望出现的内容。示例:"模糊、变形、低质量"

Wan2.6 无额外特定参数,所有可选项在通用参数中。文生 / 图生由是否传 image_urls 自动判定。

Wan2.5 预览档无额外特定参数,所有可选项在通用参数中。文生 / 图生由是否传 image_urls 自动判定。

R2V 档无额外特定参数。image_urls 必传,作为角色 / 风格参考,prompt 负责描述动作与镜头。

VideoEdit 档无额外特定参数。video_urls 必传(源视频),image_urls 可叠加风格 / 内容参考图(≤4 张),duration 由用户指定输出时长。

资源限制

项目	限制
源视频(videoedit)	MP4 / MOV,≤ 100MB,需公网可下载
参考图片	JPG / PNG / WEBP,需公网可下载链接(videoedit 最多 4 张)
Prompt	≤ 5000 字符
输出	MP4,链接 24 小时有效,请及时下载

相关文档

任务系统详解 — 任务状态机 / 轮询节奏 / 异步推送
请求响应格式 — 通用错误码 / Headers / 限流
认证 — API Key 申请与使用

HappyHorse 系列阿里云百炼欢马视频 — 单模型统一入口,智能路由 T2V/I2V/R2V/EDIT

万相 Wan 系列

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

import requests

url = "https://www.qingbo.dev/v1/tasks"

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

fetch('https://www.qingbo.dev/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://www.qingbo.dev/v1/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\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://www.qingbo.dev/v1/tasks")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"video_urls\": [\n    \"<string>\"\n  ],\n  \"resolution\": \"<string>\",\n  \"duration\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"seed\": 123,\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ]\n}")
  .asString();

{
  "task_id": "task-wave1775285160b950328499",
  "model": "wan2.7",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​定价

​调用示例

​可用模型

​通用参数

​模型特定参数

​资源限制

​相关文档

定价

调用示例

可用模型

通用参数

模型特定参数

资源限制

相关文档