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 $MODELVAULTS_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 $MODELVAULTS_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 $MODELVAULTS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "把这只猫改成赛博朋克风格，霓虹灯光，电影感构图",
    "image": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg",
    "size": "2K",
    "thinking_mode": true,
    "watermark": false
  }'

3. 多图融合

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

4. 连续多图生成

curl --location 'https://api.modelverse.cn/v1/images/generations' \
  --header "Authorization: Bearer $MODELVAULTS_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 $MODELVAULTS_API_KEY

请求体

{
  "model": "wan2.7-image-pro",
  "input": {
    "prompt": "一只坐在咖啡馆窗边的布偶猫",
    "images": [
      "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-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 $MODELVAULTS_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 $MODELVAULTS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "input": {
      "prompt": "把这只猫改成赛博朋克风格，霓虹灯光，电影感构图",
      "img_url": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg"
    },
    "parameters": {
      "size": "2K",
      "prompt_extend": true,
      "watermark": false
    }
  }'
3. 多图融合
curl --location 'https://api.modelverse.cn/v1/tasks/submit' \
  --header "Authorization: Bearer $MODELVAULTS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "input": {
      "prompt": "融合两张参考图的主体特征，生成一张高级感品牌海报",
      "images": [
        "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg",
        "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg"
      ]
    },
    "parameters": {
      "size": "2048x2048",
      "prompt_extend": true,
      "seed": 20260402
    }
  }'
4. 连续多图生成
curl --location 'https://api.modelverse.cn/v1/tasks/submit' \
  --header "Authorization: Bearer $MODELVAULTS_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 $MODELVAULTS_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": ""
}


网站现已接入AI模型

GPT
Gemini
Claude
Kimi
GLM
Minimax
Deepseek
千问
Grok
Seedance
GPT
Gemini
Claude
Kimi
GLM
Minimax
Deepseek
千问
Grok
Seedance
GPT
Gemini
Claude
Kimi
GLM
Minimax
Deepseek
千问
Grok
Seedance
GPT
Gemini
Claude
Kimi
GLM
Minimax
Deepseek
千问
Grok
Seedance