image-to-video - first frame API reference(2.1-2.6)-Wan first frame to video - Video effect templates

A video effect template is a preset for video generation effects. Provide a first-frame image and a template value to generate a video with a specific dynamic effect, such as "Magic Levitation" or "Squeeze". Important

This document applies only to the China (Beijing) region. To use the model, you must use an API key from the China (Beijing) region.

Input first-frame image	Output example 1: Use the "Magic Levitation" effect视频地址 ** The template is set to "flying"	Output example 2: Use the "Squeeze" effect**视频地址 ** The template is set to "squish"

Usage

• Scope : Video effect templates are supported only in Wan - image-to-video - first frame tasks.

• Method : In the request body, pass template to the desired template value, such as "flying". For all available templates, see Video effect templates.

• Note: When you use the template parameter, the model ignores the prompt field. Omit this field or leave it empty.

Send a request

The following example shows only the request. For a complete example, see Image-to-Video API.

HELPCODEESCAPE-curl
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wanx2.1-i2v-turbo",
    "input": {
        "img_url": "https://cdn.translate.alibaba.com/r/wanx-demo-1.png",
        "template": "flying"
    },
    "parameters": {
        "resolution": "720P"
    }
}'

Video effect templates

For optimal results, refer to the "Input image suggestions" for each template.

Model support summary

Model**	Supported templates
wanx2.1-i2v-plus	All templates
wanx2.1-i2v-turbo	General effects, Carousel, Love You, Single-person or animal effects, Two-person effects

General effects

All general effects support both wanx2.1-i2v-plus and wanx2.1-i2v-turbo.

These effects work with any entity. For best results, use an image where the entity is prominent and clearly distinguished from the background.

**Effect name **	template value	**Example effect **	Input image suggestions
Squeeze	**squish **	视频地址	- Supports any entity. - Use an image where the entity is prominent and clearly distinguished from the background.
Spin	**rotation **	视频地址	- Supports any entity. - Use an image where the entity is prominent and clearly distinguished from the background.
Poke	**poke **	视频地址	- Supports any entity. - Use an image where the entity is prominent and clearly distinguished from the background.
Balloon Inflation	**inflate **	视频地址	- Supports any entity. - Use an image where the entity is prominent and clearly distinguished from the background.
Molecular Diffusion	**dissolve **	视频地址	- Supports any entity. - Use an image where the entity is prominent and clearly distinguished from the background.

Single-person effects

**Effect name **	template parameter value	**Example effect **	Input image suggestions
Carousel	**carousel **	视频地址	- Supports single-person photos. - Use a half-body to full-body frontal photo.
Love You	**singleheart **	视频地址	- Supports single-person photos. - Use a half-body to full-body frontal photo.
Swing Time	dance1	视频地址	- Supports single-person photos. - Use a half-body to full-body frontal photo.
Swing Dance	dance2	视频地址	- Supports single-person photos. - Use a full-body frontal photo.
Star Swing	**dance3 **	视频地址	- Supports single-person photos. - Use a full-body frontal photo.
Mermaid Awakening	mermaid	视频地址	- Supports single-person photos. - Use a half-body frontal photo.
Academic Coronation	graduation	视频地址	- Supports single-person photos. - Use a half-body to full-body frontal photo.
Beast Pursuit	dragon	视频地址	- Supports single-person photos. - Use a half-body to full-body frontal photo.
Money from Heaven	money	视频地址	- Supports single-person photos. - Use a half-body to full-body frontal photo.

Single-person or animal effects

All effects in this category support both wanx2.1-i2v-plus and wanx2.1-i2v-turbo.

These effects work with single-person or animal photos.

**Effect name **	template value	**Example effect **
Magic Levitation	**flying **	视频地址
Rose for You	**rose **	视频地址
Shining Rose	**crystalrose **	视频地址

Two-person effects

All effects in this category support both wanx2.1-i2v-plus and wanx2.1-i2v-turbo.

These effects work with two-person photos. A half-body or full-body photo where both people face the camera or each other is recommended.

**Effect name **	template value	**Example effect **
Loving Hug	**hug **	视频地址
Interdependent	**frenchkiss **	视频地址
Double Heartbeat	**coupleheart **	视频地址

References

• For API parameter descriptions and code examples, see Image-to-video API.