wan/wan2.5-t2i-preview 的 API 参考,由 Comfy Router 从 Wan 提供服务。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 进行的相同调用。
模型 ID: wan/wan2.5-t2i-preview
端点: POST https://api.comfy.org/v2/models/wan/wan2.5-t2i-preview
- Wait for the result
- Queue and collect later
数据结构
输入
object
必填
输入基本信息,例如提示词等。
string
反向提示词,用于描述你不希望在图像中出现的内容
string
必填
正向提示词,用于描述期望的图像元素和视觉特征。支持中文和英文,长度不超过 800 个字符
string
调用文生图生成时使用的模型 ID。此组件不对其做约束:Comfy Router 会从
POST /v2/models/wan/{model} 的 {model} 路径段中填充它。直接以 v1 方式调用 POST /proxy/wan/api/v1/services/aigc/text2image/image-synthesis 时必须提供该值,可接受的拼写枚举定义在该操作自身的组件 WanImageGenerationRequest 上。object
图像处理参数
integer
默认值:"4"
生成图像的数量。范围 1-4,默认为 4范围:
1 到 4boolean
默认值:"true"
启用提示词智能改写。默认为 true
integer
用于控制随机性的随机数种子。范围 [0, 2147483647]范围:
0 到 2147483647string
默认值:"\"1280*1280\""
输出图像的分辨率,格式为 widthheight。默认为 12801280。API 接受的像素面积在 1638400(12801280)到 2073600(14401440)之间,宽高比在 1:4 到 4:1 之间,因此 768*2700 是有效的
boolean
默认值:"false"
是否在右下角添加水印标识
GET /v2/models/wan/wan2.5-t2i-preview/openapi.json 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。
输出
object
必填
string
智能改写后的实际提示词(用于视频任务)
string
带音频生成的 I2V 任务的音频 URL
string
失败请求的错误代码(请求成功时不返回)
string
任务完成时间
string
失败请求的详细信息(请求成功时不返回)
string
原始输入提示词(用于视频任务)
object[]
图像生成任务的任务结果列表
string
智能改写后的实际提示词(如果启用)
string
图像错误代码(部分任务失败时返回)
string
图像错误信息(部分任务失败时返回)
string
原始输入提示词
string
已生成图像的 URL 地址
string
任务执行时间
string
任务提交时间
string
必填
任务 ID
object
图像生成任务的任务结果统计
integer
失败任务数
integer
成功任务数
integer
任务总数
string
必填
任务状态可能的值:
PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED、UNKNOWNstring
已完成的视频生成任务的视频 URL。链接有效期为 24 小时
string
必填
唯一请求标识符
object
输出信息统计。仅统计成功的结果
integer
视频分辨率级别(I2V 和 wan3.0-video 任务)
number
已生成视频的时长(秒)(I2V 和 wan3.0-video 任务)
integer
已生成视频的帧率(wan3.0-video 任务)
integer
已生成图像的数量(T2I 和 I2I 任务)
number
输入视频的时长(秒),无视频输入时为 0.0(wan3.0-video 任务)
number
输出视频的时长(秒)(wan3.0-video 任务)
string
已生成视频的宽高比,例如 16:9(wan3.0-video 任务)
string
图像分辨率(T2I 和 I2I 任务)
integer
已生成视频的数量(T2V 任务)
number
已生成视频的时长(秒)(T2V 任务)
string
视频分辨率比例(T2V 任务)
string
失败请求的错误代码,报告在响应外层的根层级(ROOT),而非
output 下(请求成功时不返回)。string
失败请求的详细信息,报告在响应外层的根层级(ROOT),而非
output 下(请求成功时不返回)。在回退到 output.message 之前请先阅读此项。示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。