Wan Image 系列

POST

tasks

Wan Image 系列

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

import requests

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

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "n": 123,
    "seed": 123,
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "image_urls": ["<string>"],
    "callback_url": "<string>",
    "callback_events": ["<string>"],
    "watermark": True,
    "thinking_mode": True,
    "enable_sequential": True,
    "color_palette": [{}],
    "bbox_list": [{}]
}
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>',
    n: 123,
    seed: 123,
    aspect_ratio: '<string>',
    resolution: '<string>',
    image_urls: ['<string>'],
    callback_url: '<string>',
    callback_events: ['<string>'],
    watermark: true,
    thinking_mode: true,
    enable_sequential: true,
    color_palette: [{}],
    bbox_list: [{}]
  })
};

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  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"seed\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ],\n  \"watermark\": true,\n  \"thinking_mode\": true,\n  \"enable_sequential\": true,\n  \"color_palette\": [\n    {}\n  ],\n  \"bbox_list\": [\n    {}\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  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"seed\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ],\n  \"watermark\": true,\n  \"thinking_mode\": true,\n  \"enable_sequential\": true,\n  \"color_palette\": [\n    {}\n  ],\n  \"bbox_list\": [\n    {}\n  ]\n}")
  .asString();

{
  "task_id": "task-wave1775290140a830128812",
  "model": "wan2.7-image",
  "action": "generate",
  "status": "queued",
  "created_at": 1775290140120,
  "progress": 0
}

阿里通义万相 2.7 图像生成与编辑统一接口。提供 两个独立 model,共用同一接口与同一组参数,通过 model ID 区分,定价与最高分辨率不同:

wan2.7-image(标准版)— 最高 2K,$0.0243 / 张
wan2.7-image-pro(专业版)— 最高 4K,$0.0612 / 张

6 种调用模式:

文生图(generate) — 仅 prompt,可走思考模式
图生图(image2image) — 单参考图自由发挥
图像编辑(edit) — 局部重绘 / 风格迁移 / 元素替换
多图参考(reference) — 最多 9 张参考图融合
组图(group) — enable_sequential 连环画 / 分镜,n 上限 12
交互式编辑(interactive_edit) — bbox_list 框选区域定向编辑(独家)

按张计费。

定价

模型	单价(每张)	最高分辨率
`wan2.7-image`	`$0.0243`	2K
`wan2.7-image-pro`	`$0.0612`	4K

模式速查

模式	触发字段	action
文生图	仅 `prompt`(可加 `thinking_mode`)	`generate`
图生图	`+ image_urls`(单张)	`image2image`
图像编辑	`+ image_urls`(单张)+ 编辑指令 prompt	`edit`
多图参考融合	`+ image_urls`(2-9 张)	`reference`
组图(连环画 / 分镜)	`enable_sequential: true` + `n` ≤ 12	`group`
交互式框选编辑	`+ image_urls` + `bbox_list`	`interactive_edit`

调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro",
    "prompt": "古风山水长卷,水墨意境,远山如黛,近水含烟",
    "resolution": "4K",
    "aspect_ratio": "16:9",
    "thinking_mode": true
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "action": "reference",
    "prompt": "把第一张人物放进第二张场景,衣着借鉴第三张",
    "image_urls": [
      "https://cdn.example.com/character.jpg",
      "https://cdn.example.com/scene.jpg",
      "https://cdn.example.com/outfit.jpg"
    ],
    "resolution": "2K",
    "aspect_ratio": "3:4"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "action": "group",
    "prompt": "小狐狸的一天:晨起 / 觅食 / 嬉戏 / 入睡,4 格连环画",
    "enable_sequential": true,
    "n": 4,
    "resolution": "2K",
    "aspect_ratio": "1:1"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image",
    "action": "interactive_edit",
    "prompt": "把框中的猫换成柴犬,保持姿势和光照",
    "image_urls": ["https://cdn.example.com/cat.jpg"],
    "bbox_list": [[[120, 80, 540, 460]]],
    "resolution": "2K"
  }'

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro",
    "prompt": "极简海报,几何构图,留白克制",
    "color_palette": [
      {"hex": "#0A2540", "ratio": 50},
      {"hex": "#F5F5F0", "ratio": 35},
      {"hex": "#E04B3A", "ratio": 15}
    ],
    "resolution": "4K",
    "aspect_ratio": "2:3"
  }'

{
  "task_id": "task-wave1775290140a830128812",
  "model": "wan2.7-image",
  "action": "generate",
  "status": "queued",
  "created_at": 1775290140120,
  "progress": 0
}

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

可用模型

模型 ID	说明
`wan2.7-image`	阿里通义万相 2.7 标准版,文生 / 图生 / 编辑 / 多图参考 / 组图 / 交互式框选编辑统一接口,最高 2K
`wan2.7-image-pro`	阿里通义万相 2.7 专业版,能力同标准版,最高 4K

两个 model 共用同一接口、同一组参数,仅 model ID、定价与最高分辨率不同。

通用参数

string

必填

从可用模型列表中选一个:wan2.7-image(最高 2K)或 wan2.7-image-pro(最高 4K)

string

默认值:"generate"

操作类型,可选值:

generate — 文生图(默认)
image2image — 图生图(需配合 image_urls 单张)
edit — 图像编辑(局部重绘 / 风格迁移)
reference — 多图参考融合(最多 9 张)
group — 组图生成(配合 enable_sequential)
interactive_edit — 交互式框选编辑(配合 bbox_list)

string

必填

图像描述文本,支持中英文。组图模式建议用分镜式描述

integer

默认值:"1"

生成数量。普通模式取决于服务侧上限;组图模式(enable_sequential: true)上限 12

integer

默认值:"-1"

随机种子,-1 为随机;固定值可复现相似结果

string

默认值:"1:1"

画面宽高比,共 7 种:

1:1 — 正方形
16:9 / 9:16 — 横/竖版宽屏
4:3 / 3:4 — 横/竖版标准
3:2 / 2:3 — 横/竖版相机比

string

默认值:"2K"

输出分辨率,取决于模型:

wan2.7-image:1K / 2K
wan2.7-image-pro:1K / 2K / 4K

注意:组图模式(enable_sequential: true)上限为 2K

string[]

参考图片 URL 数组:

image2image / edit / interactive_edit:1 张
reference:2-9 张

string

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

string[]

订阅的回调事件类型,详见回调机制

模型特定参数

boolean

默认值:"false"

AI 生成水印

boolean

默认值:"true"

思考模式 — 启用后模型会先做视觉推理再出图,提升复杂 prompt 的解析准确度。生效条件:仅当非组图(enable_sequential 不为 true)且无图输入(未提供 image_urls)时生效;其他情况自动忽略

boolean

默认值:"false"

组图模式(连环画 / 分镜)。启用后:

n 上限提升到 12
resolution 上限为 2K
thinking_mode 与 color_palette 不生效

适合分镜脚本、连环画、电商多图主题等”主题相关一组”的需求

array

自定义颜色主题。3-10 项 {hex, ratio},ratio 总和需为 100%。生效条件:仅非组图模式生效。详见复合字段说明

array

交互式编辑框列表,与 image_urls 一一对应,每张图最多 2 个框。仅 action: "interactive_edit" 时生效。详见复合字段说明

复合字段说明

`color_palette` — 自定义颜色主题

为输出指定主色调与配色比例,模型会按比例在画面中分配色彩占比。结构:数组,每项为 {hex, ratio}

字段	类型	说明
`hex`	string	十六进制颜色,如 `#0A2540`,大小写不敏感
`ratio`	number	该颜色在画面中的占比(百分比),所有项之和必须为 100

约束:

项数:3-10
ratio 总和:严格 100(整数百分比)
仅非组图模式生效(enable_sequential 为 true 时忽略)

示例:

"color_palette": [
  {"hex": "#0A2540", "ratio": 50},
  {"hex": "#F5F5F0", "ratio": 35},
  {"hex": "#E04B3A", "ratio": 15}
]

`bbox_list` — 交互式编辑框

在参考图上画框,告诉模型”只编辑框内区域”,外部保持原样。是 Wan 系列在交互式编辑场景下的独家能力。结构:三层嵌套数组 [[[x1, y1, x2, y2], ...], ...]

最外层:每项对应 image_urls 中的一张图,一一对应(数量必须相等)
中间层:某张图上的多个框,单图最多 2 个框
最内层:单个框的坐标,4 个数字 [x1, y1, x2, y2],代表左上角与右下角(像素坐标)

约束:

仅 action: "interactive_edit" 时生效
每张图最多 2 个框
坐标基于参考图原始像素

示例(单图单框):

"image_urls": ["https://cdn.example.com/cat.jpg"],
"bbox_list": [[[120, 80, 540, 460]]]

示例(单图双框):

"image_urls": ["https://cdn.example.com/scene.jpg"],
"bbox_list": [[[100, 100, 400, 400], [500, 200, 800, 500]]]

示例(多图,每图各一框):

"image_urls": [
  "https://cdn.example.com/img-a.jpg",
  "https://cdn.example.com/img-b.jpg"
],
"bbox_list": [
  [[120, 80, 540, 460]],
  [[200, 150, 600, 500]]
]

资源限制

项目	限制
参考图片(`reference`)	2-9 张
参考图片(`image2image` / `edit` / `interactive_edit`)	1 张
单张图片大小	≤ 30MB,支持 JPG/PNG/WEBP
输出分辨率	`wan2.7-image`:`1K` / `2K`;`wan2.7-image-pro`:`1K` / `2K` / `4K`(组图模式均上限 `2K`)
组图数量 `n`	上限 12(需 `enable_sequential: true`)
`bbox_list` 框数	单图最多 2 个框
`color_palette` 项数	3-10 项,`ratio` 总和 100%
输出文件	JPG 链接,24 小时有效

相关文档

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

Wan Image 系列

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

import requests

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

payload = {
    "model": "<string>",
    "action": "<string>",
    "prompt": "<string>",
    "n": 123,
    "seed": 123,
    "aspect_ratio": "<string>",
    "resolution": "<string>",
    "image_urls": ["<string>"],
    "callback_url": "<string>",
    "callback_events": ["<string>"],
    "watermark": True,
    "thinking_mode": True,
    "enable_sequential": True,
    "color_palette": [{}],
    "bbox_list": [{}]
}
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>',
    n: 123,
    seed: 123,
    aspect_ratio: '<string>',
    resolution: '<string>',
    image_urls: ['<string>'],
    callback_url: '<string>',
    callback_events: ['<string>'],
    watermark: true,
    thinking_mode: true,
    enable_sequential: true,
    color_palette: [{}],
    bbox_list: [{}]
  })
};

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  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"seed\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ],\n  \"watermark\": true,\n  \"thinking_mode\": true,\n  \"enable_sequential\": true,\n  \"color_palette\": [\n    {}\n  ],\n  \"bbox_list\": [\n    {}\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  \"action\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"n\": 123,\n  \"seed\": 123,\n  \"aspect_ratio\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"image_urls\": [\n    \"<string>\"\n  ],\n  \"callback_url\": \"<string>\",\n  \"callback_events\": [\n    \"<string>\"\n  ],\n  \"watermark\": true,\n  \"thinking_mode\": true,\n  \"enable_sequential\": true,\n  \"color_palette\": [\n    {}\n  ],\n  \"bbox_list\": [\n    {}\n  ]\n}")
  .asString();

{
  "task_id": "task-wave1775290140a830128812",
  "model": "wan2.7-image",
  "action": "generate",
  "status": "queued",
  "created_at": 1775290140120,
  "progress": 0
}

文本生成

图像生成

视频生成

音频处理

工具与嵌入

任务管理

定价

模式速查

调用示例

可用模型

通用参数

模型特定参数

复合字段说明

`color_palette` — 自定义颜色主题

`bbox_list` — 交互式编辑框

资源限制

相关文档

​定价

​模式速查

​调用示例

​可用模型

​通用参数

​模型特定参数

​复合字段说明

​color_palette — 自定义颜色主题

​bbox_list — 交互式编辑框

​资源限制

​相关文档

定价

模式速查

调用示例

可用模型

通用参数

模型特定参数

复合字段说明

`color_palette` — 自定义颜色主题

`bbox_list` — 交互式编辑框

资源限制

相关文档