Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt

Use this file to discover all available pages before exploring further.

This page is for users currently on Wan2.6, explaining the differences between versions and the path to migrate to Wan2.7. New users should start from the Wan Overview.

​
Version overview

VersionStatusEndpoint / protocolRecommended for
Wan2.7✅ Currently recommended/wan/api/v1/...video-synthesisFirst choice for new integrations, most complete feature set (audio drive, multi-subject reference)
Wan2.6🟡 MaintenanceSame as Wan2.7 (change only the model name)Existing Wan2.6 code, or need the r2v-flash low-latency tier
Wan2.6 and Wan2.7 share the same DashScope passthrough endpoint and the same request structure. To migrate, just change the model field from wan2.6-* to wan2.7-* and leave the rest of the body untouched. Exact launch dates and the latest availability are authoritative in the APIYI console model list.

​
Wan2.6 models

Model IDCapabilityNotes
wan2.6-t2vText-to-videoCorresponds to wan2.7-t2v
wan2.6-i2vImage-to-videoCorresponds to wan2.7-i2v
wan2.6-r2vReference-to-videoCorresponds to wan2.7-r2v
wan2.6-r2v-flashReference-to-video (low-latency tier)A fast tier exclusive to Wan2.6: faster generation, lower unit price, ideal for iterating, debugging, and batch previews
wan2.6-r2v-flash is the lightweight fast tier in the Wan2.6 series, with no 2.7 equivalent. Use it during development to quickly validate prompts and reference-image results, then switch to wan2.7-r2v for the final render once finalized.

​
Migration tips

1

Assess the differences

Wan2.7 is stronger at multi-subject reference, voice reference (reference_voice), and audio drive. If you only use basic t2v / i2v / r2v, the migration cost is nearly zero.
2

Run a side-by-side comparison

Using the same set of prompts and media assets, submit wan2.6-* and wan2.7-* tasks separately, compare quality and consistency, and then decide whether to switch.
3

Switch gradually

Just change the model field. The endpoint, headers, input / parameters structure, and polling and download flow are identical, with no breaking change.

​
Legacy call example

import requests

# Calling Wan2.6: the only difference from Wan2.7 is the model name
body = {
    "model": "wan2.6-r2v-flash",   # change to wan2.7-r2v to upgrade to 2.7
    "input": {
        "prompt": "The reference image: a girl walking slowly through a garden, cinematic lighting",
        "media": [{"type": "reference_image", "url": "https://your-cdn.com/girl.png"}],
    },
    "parameters": {"resolution": "720P", "duration": 5, "prompt_extend": True},
}
resp = requests.post(
    "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis",
    json=body,
    headers={"Authorization": "Bearer sk-your-api-key", "Content-Type": "application/json",
             "X-DashScope-Async": "enable"},
    timeout=30,
)
print(resp.json()["output"]["task_id"])

​
Billing differences

Pricing and group configuration for both Wan2.6 and Wan2.7 are coming soon and will be added to this page. As a general rule: fast tiers like r2v-flash have a lower unit price, while higher resolution / longer durations cost more. The latest prices are authoritative on the APIYI console billing page.

Wan Overview

Async flow, parameter details, best practices

Reference-to-Video

wan2.7-r2v live debugging