跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Wan 2.7 Image 标准版

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 wan2.7-image-standard
类型 文生图 / 参考图编辑
接口 POST /v1/tasks
价格 见 HiAPI 定价

Wan 2.7 Image 标准版：一个模型同时支持文生图与参考图编辑（最多 9 张参考图），支持 1K/2K 输出，通过统一异步接口生成图片。

生产建议

生产环境建议
  • 生产环境优先传 callback.url 接收终态通知，GET /v1/tasks/:id 用于本地调试或补偿查询。
  • 做参考图编辑时，把源图放在数组第一张，其他参考图按顺序追加，并在提示词中按顺序指代。
  • 传入参考图后不要依赖 aspect_ratio；画幅由最后一张参考图决定。

适用场景

文生图与编辑一体

一个模型 ID 覆盖纯文生图和参考图编辑，不需要切换线路。

promptimage_urls
中文与英文提示词

两种语言均可使用，适合中文海报、店招与双语物料。

prompt
灵活画幅与 1K/2K

八种画幅覆盖方形、横版、竖版和超宽条幅；草稿与成品可分开输出。

aspect_ratioresolution
可复现迭代

固定 seed 后对比提示词变化，适合逐步收敛画面。

seed

请求参数

model string 必填

固定填 wan2.7-image-standard。

示例 wan2.7-image-standard
input object 必填

模型专属参数对象。

prompt string 必填

描述要生成的画面，或说明要对参考图做哪些修改。中英文均可，1–5000 字符。

image_urls string[] 可选

参考图或待编辑图片的公网 URL，最多 9 张；不传即为文生图。支持 JPEG、PNG、BMP、WebP；单张不超过 20 MB，边长 240–8000 像素，宽高比 1:8–8:1。传入图片后，输出画幅跟随最后一张参考图。

aspect_ratio enum 可选

纯文生图时使用的输出画幅。传入参考图后画幅由最后一张图决定，无需设置。

默认 1:1 可选值: 1:116:94:321:93:49:168:11:8
resolution enum 可选

输出分辨率档位：1K 约 1024²，2K 约 2048² 总像素量级。

默认 2K 可选值: 1K2K
seed integer 可选

随机种子，0–2147483647。固定 seed 可让结果相对稳定，不保证完全一致。

callback object 可选

可选回调配置。生产环境建议传 callback.url 接收任务终态通知。

url string 必填

接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；使用 final。

默认 final 可选值: final

用例示例

文生图黄金示例（1K，16:9）

与 DEV 黄金任务同源：蓝调时刻的雨后弄堂，暖色纸灯笼、釉面茶壶、湿石反光与自行车。

请求体
{
  "model": "wan2.7-image-standard",
  "input": {
    "prompt": "A quiet Shanghai lane at blue hour after rain, a small ceramic studio with warm paper lanterns, glazed teapots in the window, wet stone reflections, a bicycle leaning against the wall, cinematic 35mm photograph, high detail",
    "aspect_ratio": "16:9",
    "resolution": "1K",
    "seed": 20261019
  }
}
参考图编辑（单张参考图）

把同一张黄金产物作为源图，通过提示词改成清晨场景，同时保留建筑、自行车与弄堂结构。

请求体
{
  "model": "wan2.7-image-standard",
  "input": {
    "prompt": "Turn the reference into a clear morning scene: keep the studio facade, the bicycle, and the lane structure; replace the paper lanterns with open shutters and add soft morning sunlight and long shadows",
    "image_urls": [
      "https://dev-static.hiapi.ai/admin-assets/2026/10/19/1792422144916-ff0acf94218f32b6-golden.webp"
    ],
    "resolution": "1K"
  }
}

获取结果

  1. 提交成功后立即返回 taskId。
  2. 生产环境优先等待 callback.url；本地调试可轮询 GET /v1/tasks/:id。
  3. status=success 后从 output[].url 下载图片。
  4. status=fail 时按错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

Wan 2.7 Image 与 Pro 有什么区别？

标准版支持 1K 和 2K 输出，覆盖文生图与参考图编辑；需要 4K 文生图时使用 Wan 2.7 Image Pro。

支持参考图编辑吗？

支持。传入最多 9 张公网图片 URL，并在提示词中说明要修改的内容；不传图片时按提示词生成。

有参考图时还能设置画幅吗？

输出画幅跟随最后一张参考图，此时无需设置 aspect_ratio。纯文生图时可用八种画幅之一。

一次请求生成几张图片？

当前 HiAPI 契约每次请求输出 1 张图片，按成功生成的图片计费。 查看实时价格

参考图支持哪些格式和大小？

支持 JPEG、PNG、BMP、WebP，单张不超过 20 MB，边长 240–8000 像素，宽高比 1:8–8:1。

如何复现结果？

固定 seed、提示词、参考图顺序、画幅和分辨率后重新提交；相同设置可让结果相对稳定，但不保证完全一致。

下一步