# 首尾帧生成视频

**方法**: `POST`
**路径**: `/qwen/api/v1/services/aigc/image2video/video-synthesis`

[官方api 文档](https://bailian.console.aliyun.com/?spm=5176.12818093_47.resourceCenter.1.3a9d2cc9l8f5UQ&userCode=okjhlpr5&tab=api#/api/?type=model&url=2880649)

通义万相首尾帧生视频模型基于首帧图像、尾帧图像和文本提示词，生成一段平滑过渡的视频。支持的能力包括：

基础能力：视频时长固定（5秒）、指定视频分辨率（480P/720P/1080P）、智能改写prompt、添加水印。

特效模板：仅输入首帧图片，并选择一个特效模板，即可生成具有特定动态效果的视频。

## 请求参数

### Header 参数

```text
X-DashScope-Async
string
必需
示例:
enable
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json 必填

```text
model
string
必需
input
object
必需
first_frame_url
string
必需
首帧图像的URL或 Base64 编码数据。输出视频的宽高比将以此图像为基准。
图像限制：
图像格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。
图像分辨率：图像的宽度和高度范围为[360, 2000]，单位为像素。
文件大小：不超过10MB。
输入图像说明：
使用公网可访问URL
支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件获取临时URL。
示例值：
https://wanx.alicdn.com/material/20250318/first_frame.png。
传入 Base64 编码图像后的字符串
数据格式：data:{MIME_type};base64,{base64_data}。
示例值：data:image/png;base64,GDU7MtCZzEbTbmRZ......。
last_frame_url
string
可选
尾帧图像的URL或 Base64 编码数据。
图像限制：
图像格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。
图像分辨率：图像的宽度和高度范围为[360, 2000]，单位为像素。尾帧图像分辨率可与首帧不同，无需强制对齐。
文件大小：不超过10MB。
输入图像说明：
使用公网可访问URL
支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件获取临时URL。
示例值：
https://wanx.alicdn.com/material/20250318/last_frame.png。
使用 Base64 编码图像文件
数据格式：data:{MIME_type};base64,{base64_data}。
示例值：data:image/png;base64,VBORw0KGgoAAAANSUh......。（编码字符串过长，仅展示片段）
prompt
string
可选
文本提示词。支持中英文，长度不超过800个字符，每个汉字/字母占一个字符，超过部分会自动截断。
如果首尾帧的主体和场景变化较大，建议描写变化过程，例如运镜过程（镜头向左移动）、或者主体运动过程（人向前奔跑）。
示例值：一只黑色小猫好奇地看向天空，镜头从平视逐渐上升，最后俯拍它的好奇的眼神。
negative_prompt
string
可选
反向提示词，用来描述不希望在视频画面中看到的内容，可以对视频画面进行限制。
支持中英文，长度不超过500个字符，超过部分会自动截断。
示例值：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。
template
string
可选
视频特效模板的名称。使用此参数时，仅需传入 first_frame_url。
不同模型支持不同的特效模板。调用前请查阅视频特效列表，以免调用失败。
示例值：hufu-1，表示使用“唐韵翩然”特效。
parameters
object
必需
resolution
string
可选
生成的视频分辨率档位。仅用于调整视频的清晰度（总像素），不改变视频的宽高比，视频宽高比将与首帧图像 first_frame_url 的宽高比保持一致。
此参数的默认值和可用枚举值依赖于 model 参数，规则如下：
wan2.2-kf2v-flash：可选值：480P、720P、1080P。默认值为720P。
wanx2.1-kf2v-plus：可选值：720P。默认值为720P。
示例值：720P。
duration
integer
可选
视频生成时长，单位为秒。当前参数值固定为5，且不支持修改。模型将始终生成5秒时长的视频。
watermark
boolean
可选
是否添加水印标识，水印位于图片右下角，文案为“AI生成”。
false：默认值，不添加水印。
true：添加水印。
示例值：false。
prompt_extend
boolean
可选
是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显，但会增加耗时。
true：默认值，开启智能改写。
false：不开启智能改写。
示例值：true。
seed
integer
可选
随机数种子。取值范围是[0, 2147483647]。
未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。
请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。
示例值：12345。
示例
{
"model"
:
"wan2.2-kf2v-flash"
,
"input"
:
{
"first_frame_url"
:
"https://wanx.alicdn.com/material/20250318/first_frame.png"
,
"last_frame_url"
:
"https://wanx.alicdn.com/material/20250318/last_frame.png"
,
"prompt"
:
"写实风格，一只黑色小猫好奇地看向天空，镜头从平视逐渐上升，最后俯拍它的好奇的眼神。"
}
,
"parameters"
:
{
"resolution"
:
"480P"
,
"prompt_extend"
:
true
}
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/qwen/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "wan2.2-kf2v-flash",
    "input": {
        "first_frame_url": "https://wanx.alicdn.com/material/20250318/first_frame.png",
        "last_frame_url": "https://wanx.alicdn.com/material/20250318/last_frame.png",
        "prompt": "写实风格，一只黑色小猫好奇地看向天空，镜头从平视逐渐上升，最后俯拍它的好奇的眼神。"
    },
    "parameters": {
        "resolution": "480P",
        "prompt_extend": true
    }
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{}
```