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://airouter.xincache.cn/v1/images/generations

认证方式

Authorization: Bearer $XINNETMODEL_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://airouter.xincache.cn/v1/images/generations' \
  --header "Authorization: Bearer $XINNETMODEL_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://airouter.xincache.cn/v1/images/generations' \
  --header "Authorization: Bearer $XINNETMODEL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "prompt": "把这只猫改成赛博朋克风格，霓虹灯光，电影感构图",
    "image": "https://static.xinnet.com/xinnetmodel/xinnet-maxcot.jpg",
    "size": "2K",
    "thinking_mode": true,
    "watermark": false
  }'

3. 多图融合

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

4. 连续多图生成

curl --location 'https://airouter.xincache.cn/v1/images/generations' \
  --header "Authorization: Bearer $XINNETMODEL_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://airouter.xincache.cn/v1/tasks/submit

认证方式

Authorization: Bearer $XINNETMODEL_API_KEY

请求体

{
  "model": "wan2.7-image-pro",
  "input": {
    "prompt": "一只坐在咖啡馆窗边的布偶猫",
    "images": [
      "https://static.xinnet.com/xinnetmodel/xinnet-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://airouter.xincache.cn/v1/tasks/submit' \
  --header "Authorization: Bearer $XINNETMODEL_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://airouter.xincache.cn/v1/tasks/submit' \
  --header "Authorization: Bearer $XINNETMODEL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.7-image-pro",
    "input": {
      "prompt": "把这只猫改成赛博朋克风格，霓虹灯光，电影感构图",
      "img_url": "https://static.xinnet.com/xinnetmodel/xinnet-maxcot.jpg"
    },
    "parameters": {
      "size": "2K",
      "prompt_extend": true,
      "watermark": false
    }
  }'

3. 多图融合

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

4. 连续多图生成

curl --location 'https://airouter.xincache.cn/v1/tasks/submit' \
  --header "Authorization: Bearer $XINNETMODEL_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://airouter.xincache.cn/v1/tasks/status?task_id=<task_id>

请求示例

curl --location 'https://airouter.xincache.cn/v1/tasks/status?task_id=<task_id>' \
  --header "Authorization: Bearer $XINNETMODEL_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": ""
}

Last modified: 25 April 2026