Wan-AI/Wan2.7 Image API

本文介绍 wan2.7-image、wan2.7-image-pro 模型调用 API 的输入输出参数，供您使用接口时查阅字段含义。

同步接口：/v1/images/generations
异步接口：/v1/tasks/submit + /v1/tasks/status

模型列表

模型名	说明
`wan2.7-image`	Wan2.7 图片生成模型
`wan2.7-image-pro`	Wan2.7 图片生成 Pro 模型

能力概览

Wan2.7 当前支持：

文生图
单图编辑
多图融合 / 多图编辑
连续多图生成 / 组图生成

OpenAI 兼容接口（同步）

接口

POST https://api.modelverse.cn/v1/images/generations

认证方式

Authorization: Bearer $MODELVERSE_API_KEY

请求参数

字段名	类型	是否必须	默认值	描述
model	string	必须	-	模型名称，可选值：`wan2.7-image`、`wan2.7-image-pro`
prompt	string	可选	-	文本提示词。`prompt`、`image`、`images` 至少需要提供一项。
image	string	可选	-	单图输入，支持公网 URL 或 Base64。适用于单图编辑场景。
images	array[string]	可选	-	多图输入，支持公网 URL 或 Base64。适用于多图融合、多图编辑场景。若同时传入 `images` 和 `image`，优先使用 `images`。
size	string	可选	-	输出尺寸，支持 `1K`、`2K`、`4K`，也兼容 `1024x1024`、`2048x2048`、`4096x4096`
n	int	可选	1	生成图片数量。普通模式建议 `1~4`，开启 `enable_sequential` 时可传更多张数。
seed	int	可选	-	随机种子。建议传正整数；传 `0` 或不传时按未设置处理。
watermark	boolean	可选	false	是否添加水印。
thinking_mode	boolean	可选	false	是否开启深度思考模式。
enable_sequential	boolean	可选	false	是否开启连续多图生成 / 组图模式。建议与 `n` 配合使用。

请求示例

1. 文生图

curl --location 'https://api.modelverse.cn/v1/images/generations' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image",
 "prompt": "A futuristic cloud data center floating above the sea at sunrise",
 "size": "1K",
 "seed": 123456,
 "watermark": false
 }'

2. 单图编辑

curl --location 'https://api.modelverse.cn/v1/images/generations' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image-pro",
 "prompt": "把这只猫改成赛博朋克风格，霓虹灯光，电影感构图",
 "image": "https://umodelverse-inference.cn-wlcb.ufileos.com/亿恩科技-maxcot.jpg",
 "size": "2K",
 "thinking_mode": true,
 "watermark": false
 }'

3. 多图融合

curl --location 'https://api.modelverse.cn/v1/images/generations' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image-pro",
 "prompt": "融合两张参考图的主体特征，生成一张高级感品牌海报",
 "images": [
 "https://umodelverse-inference.cn-wlcb.ufileos.com/亿恩科技-maxcot.jpg",
 "https://umodelverse-inference.cn-wlcb.ufileos.com/亿恩科技-maxcot.jpg"
 ],
 "size": "2048x2048",
 "thinking_mode": true,
 "seed": 20260402
 }'

4. 连续多图生成

curl --location 'https://api.modelverse.cn/v1/images/generations' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image-pro",
 "prompt": "生成一组同一角色在春夏秋冬四季中的海报，人物形象保持一致",
 "size": "2K",
 "thinking_mode": true,
 "enable_sequential": true,
 "n": 4
 }'

响应参数

字段名	类型	描述
created	integer	本次请求创建时间的 Unix 时间戳（秒）
data	array	输出图片信息列表
data.url	string	生成图片的下载地址

响应示例

{
 "created": 1775558400,
 "data": [
 {
 "url": "https://example.com/generated-image-1.png"
 },
 {
 "url": "https://example.com/generated-image-2.png"
 }
 ]
}

异步任务接口

提交任务

接口

POST https://api.modelverse.cn/v1/tasks/submit

认证方式

Authorization: Bearer $MODELVERSE_API_KEY

请求体

{
 "model": "wan2.7-image-pro",
 "input": {
 "prompt": "一只坐在咖啡馆窗边的布偶猫",
 "images": [
 "https://umodelverse-inference.cn-wlcb.ufileos.com/亿恩科技-maxcot.jpg"
 ]
 },
 "parameters": {
 "size": "2K",
 "prompt_extend": true,
 "enable_sequential": true,
 "n": 4,
 "seed": 123456,
 "watermark": false
 }
}

请求参数

字段名	类型	是否必须	描述
model	string	必须	模型名称，可选值：`wan2.7-image`、`wan2.7-image-pro`
input.prompt	string	可选	文本提示词。`input.prompt`、`input.images`、`input.img_url`、`input.first_frame_url` 至少需要提供一项。
input.images	array[string]	可选	多图输入，支持公网 URL 或 Base64。若同时传入 `input.images`、`input.img_url`、`input.first_frame_url`，优先使用 `input.images`。
input.img_url	string	可选	单图输入，支持公网 URL 或 Base64。适用于单图编辑场景。
input.first_frame_url	string	可选	单图兼容字段，支持公网 URL 或 Base64。在 Wan2.7 图片任务中会按普通图片输入处理。
parameters.size	string	可选	输出尺寸，支持 `1K`、`2K`、`4K`，也兼容 `1024x1024`、`2048x2048`、`4096x4096`。
parameters.n	int	可选	生成图片数量。取值范围 `1~4`
parameters.seed	int	可选	随机种子。建议传正整数；传 `0` 或不传时按未设置处理。
parameters.watermark	boolean	可选	是否添加水印。
parameters.enable_sequential	boolean	可选	是否开启连续多图生成 / 组图模式。通常建议与 `parameters.n` 配合使用。
parameters.prompt_extend	boolean	可选	提示词增强开关，传 `true` 时会映射为 Wan2.7 的 `thinking_mode=true`。

请求示例

1. 文生图

curl --location 'https://api.modelverse.cn/v1/tasks/submit' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image",
 "input": {
 "prompt": "A futuristic cloud data center floating above the sea at sunrise"
 },
 "parameters": {
 "size": "1K",
 "seed": 123456
 }
 }'

2. 单图编辑

curl --location 'https://api.modelverse.cn/v1/tasks/submit' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image-pro",
 "input": {
 "prompt": "把这只猫改成赛博朋克风格，霓虹灯光，电影感构图",
 "img_url": "https://umodelverse-inference.cn-wlcb.ufileos.com/亿恩科技-maxcot.jpg"
 },
 "parameters": {
 "size": "2K",
 "prompt_extend": true,
 "watermark": false
 }
 }'

3. 多图融合

curl --location 'https://api.modelverse.cn/v1/tasks/submit' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image-pro",
 "input": {
 "prompt": "融合两张参考图的主体特征，生成一张高级感品牌海报",
 "images": [
 "https://umodelverse-inference.cn-wlcb.ufileos.com/亿恩科技-maxcot.jpg",
 "https://umodelverse-inference.cn-wlcb.ufileos.com/亿恩科技-maxcot.jpg"
 ]
 },
 "parameters": {
 "size": "2048x2048",
 "prompt_extend": true,
 "seed": 20260402
 }
 }'

4. 连续多图生成

curl --location 'https://api.modelverse.cn/v1/tasks/submit' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY" \
 --header 'Content-Type: application/json' \
 --data '{
 "model": "wan2.7-image-pro",
 "input": {
 "prompt": "生成一组同一角色在春夏秋冬四季中的海报，人物形象保持一致"
 },
 "parameters": {
 "size": "2K",
 "prompt_extend": true,
 "enable_sequential": true,
 "n": 4
 }
 }'

提交响应参数

字段名	类型	描述
output.task_id	string	异步任务唯一标识
request_id	string	请求唯一标识

提交响应示例

{
 "output": {
 "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d"
 },
 "request_id": "req_202604021530000001"
}

查询任务状态

接口

GET https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>

请求示例

curl --location 'https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>' \
 --header "Authorization: Bearer $MODELVERSE_API_KEY"

响应参数

字段名	类型	描述
output.task_id	string	异步任务唯一标识
output.task_status	string	任务状态：`Pending`、`Running`、`Success`、`Failure`、`Cancelled`
output.urls	array[string]	图片结果 URL 列表
output.submit_time	integer	任务提交时间戳
output.finish_time	integer	任务完成时间戳
output.error_message	string	失败时返回的错误信息
usage.completion_tokens	integer	可选，输出 token 数
usage.total_tokens	integer	可选，总 token 数
request_id	string	请求唯一标识

响应示例（成功）

{
 "output": {
 "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d",
 "task_status": "Success",
 "urls": [
 "https://example.com/generated-image-1.png",
 "https://example.com/generated-image-2.png",
 "https://example.com/generated-image-3.png",
 "https://example.com/generated-image-4.png"
 ],
 "submit_time": 1775115000,
 "finish_time": 1775115038
 },
 "usage": {
 "completion_tokens": 4,
 "total_tokens": 4
 },
 "request_id": ""
}

响应示例（失败）

{
 "output": {
 "task_id": "3c7d6b6c-7cdb-4f37-bf41-7f2b0f1a9f0d",
 "task_status": "Failure",
 "submit_time": 1775115000,
 "finish_time": 1775115012,
 "error_message": "code=InvalidParameter, message=invalid image url"
 },
 "request_id": ""
}

服务器租用

服务器托管

机柜批发

云服务器

建站侠

空间/域名

安全保姆

Wan-AI/Wan2.7 Image API

模型列表

能力概览

OpenAI 兼容接口（同步）

接口

认证方式

请求参数

请求示例

1. 文生图

2. 单图编辑

3. 多图融合

4. 连续多图生成

响应参数

响应示例

异步任务接口

提交任务

接口

认证方式

请求体

请求参数

请求示例

1. 文生图

2. 单图编辑

3. 多图融合

4. 连续多图生成

提交响应参数

提交响应示例

查询任务状态

接口

请求示例

响应参数

响应示例（成功）

响应示例（失败）

亿恩公告

在线客服