wan2.7 视频生成模型接入指南

wan2.7 是阿里云百炼平台提供的最新视频生成模型系列，支持文生视频、图生视频、参考生视频等多种模式，具备更强的生成能力和更多的参数控制选项。

接口基地址: https://api.numspirit.com/

模型列表

模型ID	功能	说明
`wan2.7-t2v`	文生视频	根据文本描述生成视频
`wan2.7-i2v`	图生视频	根据输入图片生成视频
`wan2.7-r2v`	参考生视频	根据参考图片/视频生成视频

接口概览

功能	接口路径	方法	说明
视频生成	`/v1/videos/generations`	POST	提交视频生成任务
任务查询	`/v1/videos/generations/{task_id}`	GET	查询任务状态

1. 文生视频 - wan2.7-t2v

根据文本描述生成视频，支持多镜头叙事、音频驱动、反向提示词等高级功能。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`wan2.7-t2v`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率：`720P` 或 `1080P`
`ratio`	string	是	宽高比：`16:9`、`9:16`、`1:1` 等
`duration`	integer	是	时长（秒）：3-15
`negative_prompt`	string	否	反向提示词，排除不想要的内容
`audio_url`	string	否	音频文件URL，用于音频驱动视频
`prompt_extend`	boolean	否	是否开启提示词扩展，默认 `true`
`watermark`	boolean	否	是否添加水印，默认 `true`

基础示例

带反向提示词

多镜头叙事

音频驱动

2. 图生视频 - wan2.7-i2v

基于图片生成视频，支持首帧生成、首尾帧生成、视频续写、音频驱动等多种模式。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`wan2.7-i2v`
`prompt`	string	是	视频描述文本
`resolution`	string	是	分辨率：`720P` 或 `1080P`
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：3-15
`media`	array	是	媒体列表
`prompt_extend`	boolean	否	是否开启提示词扩展，默认 `true`
`watermark`	boolean	否	是否添加水印，默认 `true`

media 参数说明

类型	说明
`first_frame`	首帧图片
`last_frame`	尾帧图片（可选，用于首尾帧生成）
`first_clip`	输入视频片段（用于视频续写）
`driving_audio`	驱动音频（用于音频驱动）

首帧生视频

首尾帧生视频

视频续写

带音频驱动

3. 参考生视频 - wan2.7-r2v

根据参考图片/视频生成视频，支持多主体参考和单图参考。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID：`wan2.7-r2v`
`prompt`	string	是	视频描述文本，可引用参考对象
`resolution`	string	是	分辨率：`720P` 或 `1080P`
`ratio`	string	是	宽高比
`duration`	integer	是	时长（秒）：3-15
`media`	array	是	参考媒体列表
`prompt_extend`	boolean	否	是否开启提示词扩展，默认 `true`
`watermark`	boolean	否	是否添加水印，默认 `true`

media 参数说明

类型	说明
`reference_image`	参考图片
`reference_video`	参考视频（可选 `reference_voice` 音色）

多主体参考

单图参考

4. 查询任务状态

接口

GET https://api.numspirit.com/v1/videos/generations/{task_id}

说明

task_id: 创建任务时返回的任务ID

model: 创建任务时使用的模型ID（用于确定查询渠道）

cURL 示例

响应示例（进行中）

{
  "success": true,
  "data": {
    "task_id": "9dc4e5f1-69b5-4874-b475-f815b8a30a5d",
    "status": "running",
    "output_urls": [],
    "error": null
  }
}

响应示例（成功）

{
  "success": true,
  "data": {
    "task_id": "9dc4e5f1-69b5-4874-b475-f815b8a30a5d",
    "status": "succeeded",
    "output_urls": [
      "https://dashscope-a717.oss-accelerate.aliyuncs.com/xxx.mp4"
    ],
    "error": null
  }
}

通用参数说明

resolution（分辨率）

值	说明
`720P`	高清 720P
`1080P`	全高清 1080P

ratio（宽高比）

值	说明
`16:9`	横屏（默认）
`9:16`	竖屏
`1:1`	正方形
`4:3`	标准屏
`3:4`	竖屏

duration（时长）

范围：3-15 秒

默认：5 秒

prompt_extend（提示词扩展）

类型：boolean

默认：true

说明：开启后系统会自动扩展和优化提示词，提升生成效果

watermark（水印）

类型：boolean

默认：true

说明：是否在生成视频中添加水印

附录：文件上传接口

wan2.7 模型的图生视频、参考生视频、音频驱动等功能需要图片或音频文件。你可以通过以下接口上传文件到阿里云 OSS，获取临时签名 URL。

单文件上传

接口: POST https://api.numspirit.com/v1/uploads

请求 Header:

Authorization: Bearer sk-silievo-xxxxxxxx
Content-Type: multipart/form-data

请求参数:

参数	类型	必填	说明
`file`	File	是	要上传的文件（图片/音频/视频）

支持的文件类型:

图片：image/png, image/jpeg, image/webp, image/gif

音频：audio/mpeg, audio/wav, audio/mp3, audio/aac, audio/ogg, audio/flac

视频：video/mp4, video/webm, video/quicktime

cURL 示例:

响应示例:

{
  "success": true,
  "data": {
    "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx.jpg?Expires=...",
    "oss_key": "users/123/uploads/2026-07/xxx.jpg",
    "mime": "image/jpeg",
    "size": 102400
  }
}

批量文件上传

接口: POST https://api.numspirit.com/v1/uploads/batch

请求参数:

参数	类型	必填	说明
`files`	File[]	是	要上传的文件列表（最多 5 个）

cURL 示例:

响应示例:

{
  "success": true,
  "data": [
    {
      "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx1.jpg?Expires=...",
      "oss_key": "users/123/uploads/2026-07/xxx1.jpg",
      "mime": "image/jpeg",
      "size": 102400
    },
    {
      "url": "https://numspirit-media.oss-cn-shenzhen.aliyuncs.com/users/123/uploads/2026-07/xxx2.png?Expires=...",
      "oss_key": "users/123/uploads/2026-07/xxx2.png",
      "mime": "image/png",
      "size": 204800
    }
  ]
}

使用上传后的 URL

上传成功后，将返回的 url 作为 media.url 或 audio_url 参数传入视频生成接口：

图生视频示例:

音频驱动示例:

wan2.7视频模型接口

wan2.7 视频生成模型接入指南#

模型列表#

接口概览#

1. 文生视频 - wan2.7-t2v#

请求参数#

基础示例#

带反向提示词#

多镜头叙事#

音频驱动#

2. 图生视频 - wan2.7-i2v#

请求参数#

media 参数说明#

首帧生视频#

首尾帧生视频#

视频续写#

带音频驱动#

3. 参考生视频 - wan2.7-r2v#

请求参数#

media 参数说明#

多主体参考#

单图参考#

4. 查询任务状态#

接口#

说明#

cURL 示例#

响应示例（进行中）#

响应示例（成功）#

通用参数说明#

resolution（分辨率）#

ratio（宽高比）#

duration（时长）#

prompt_extend（提示词扩展）#

watermark（水印）#

附录：文件上传接口#

单文件上传#

批量文件上传#

使用上传后的 URL#

wan2.7 视频生成模型接入指南

模型列表

接口概览

1. 文生视频 - wan2.7-t2v

请求参数

基础示例

带反向提示词

多镜头叙事

音频驱动

2. 图生视频 - wan2.7-i2v

请求参数

media 参数说明

首帧生视频

首尾帧生视频

视频续写

带音频驱动

3. 参考生视频 - wan2.7-r2v

请求参数

media 参数说明

多主体参考

单图参考

4. 查询任务状态

接口

说明

cURL 示例

响应示例（进行中）

响应示例（成功）

通用参数说明

resolution（分辨率）

ratio（宽高比）

duration（时长）

prompt_extend（提示词扩展）

watermark（水印）

附录：文件上传接口

单文件上传

批量文件上传

使用上传后的 URL