Wan 2.7 API

Wan 2.7 video from a prompt, from the first and last frames or from references with characters, objects and places. 2 to 15 seconds, 720p or 1080p, with the option to add your own sound and split the video into scenes.

Developer: AlibabaModel key in the API: wan

For AI assistants:Download .md All documentation .md Open as text

Connect in three steps

Get a keyCreate a key in the dashboard after you confirm your email. One key opens every model.
Check the pricePOST /v1/price shows the cost of a run in advance, without charging you.
Run a task and collect the resultPOST /v1/tasks starts a task, GET /v1/tasks/{id} shows its status and files.

Ready-to-use code

Replace YOUR_API_KEY with your key. The code starts a task and waits for the result. In cURL, repeat the second request with the id from the first response instead of TASK_ID until status becomes succeeded.

cURLPythonNode.js

cURL

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_7",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "wan",
    "settings": {
        "mode": "text",
        "model": "2_7",
        "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
        "quality": "720p",
        "aspect_ratio": "16:9",
        "duration": "5s",
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])

Node.js

const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_7",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();

Get a key

Price before the run

Prices as of 15.10.2026: from 16 ₽. POST /v1/price shows the exact price of your settings.

Mode	Price
From a prompt	from 16 ₽
From frames	from 16 ₽
From references with a 1 s file	from 24 ₽

Send the same settings to POST /v1/price: the response shows the price of the run without charging you.

cURL

curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_7",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
}'

amount_minor: the price of the run in minor units (kopecks for rubles)
currency: the wallet currency
available_minor: how much your balance has for new tasks right now

Modes

Each mode has its own parameters and examples. The mode is set by the mode field.

From a prompt mode = text
From frames mode = frames
From references mode = reference

From a prompt

Video from text alone. Versions 2.5, 2.6 and 2.7; Wan 3.0 has no such mode.

Value of the mode field: text

Price in this mode from 16 ₽.

Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

promptRequired: What happens in the video: scene, motion, camera, style. Up to 5,000 characters.
Type: StringMinimum characters: 1Maximum characters: 5000
modelOptional: Wan version: 2.5, 2.6 or 2.7.
Type: StringAllowed values: 2_7Default: "2_7"
qualityOptional: Video resolution; the set depends on the version. The price per second depends on it.
Type: StringAllowed values: 720p1080pDefault: "720p"
aspect_ratioOptional: Frame shape. Wan 2.5 at 480p offers only 16:9, 9:16 and 1:1.
Type: StringAllowed values: 16:99:161:14:33:4The set depends on quality.Default: "16:9"
durationOptional: Video length: 5 or 10 seconds for Wan 2.5, 2 to 15 for 2.6 and 2.7. The price is per second.
Type: StringAllowed values: 2s3s4s5s6s7s8s9s10s11s12s13s14s15sDefault: "5s"
multi_shotsOptional: Split the video into several scenes. Wan 2.6 and 2.7 only.
Type: BooleanDefault: false
audioOptional: Your own sound for the video, such as a voice or music: one URL. Available in Wan 2.6 and 2.7. Sound longer than the video is cut to its length.
Type: List (String, uri)Maximum items: 1

Parameters not listed here are not accepted: the response is 422 unknown_setting.

Input

Sound is a URL of an MP3 or WAV file up to 10 MB.

Field	Accepts	Formats	Files	File size up to
`audio`	Audio	mp3, wav	1	10 MB

How to send files

Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Video from a prompt

JSON

{
  "model": "wan",
  "settings": {
    "mode": "text",
    "model": "2_7",
    "prompt": "Кот играет с клубком на солнечном подоконнике, камера медленно приближается",
    "quality": "720p",
    "aspect_ratio": "16:9",
    "duration": "5s"
  }
}

The price is calculated when the task is accepted, currency RUB.

Complete generation example

Output

One MP4 video.
Generation usually takes 5 to 10 minutes.

Kind	Formats	How many	Note
`video`	mp4	1

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

How to read the result and download files

From frames

The first frame, or the first and the last one: the model animates them by the prompt. Wan 3.0 needs a frame, the other versions also work without one.

Value of the mode field: frames

This page is about Wan 2.7: send model = 2_7. Without the model field the task runs on 3_0.

Price in this mode from 16 ₽.

Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

promptRequired: What happens in the video: scene, motion, camera, style. Up to 5,000 characters, up to 20,000 for Wan 3.0.
Type: StringMinimum characters: 1Maximum characters: 20000
image_urlsOptional: One URL: the first frame. Two URLs: the first and the last frames.
Type: List (String, uri)Maximum items: 2
modelOptional: Wan version. 3.0, the newest one, has no own sound and no splitting into scenes.
Type: StringAllowed values: 2_7Default: "3_0"
qualityOptional: Video resolution; the set depends on the version. The price per second depends on it.
Type: StringAllowed values: 720p1080pDefault: "720p"
aspect_ratioOptional: Frame shape. Wan 2.5 at 480p offers only 16:9, 9:16 and 1:1.
Type: StringAllowed values: 16:99:161:14:33:4The set depends on quality.Default: "16:9"
durationOptional: Video length: 5 or 10 seconds for Wan 2.5, 2 to 15 for 2.6 and 2.7, 2 to 30 for 3.0. The price is per second.
Type: StringAllowed values: 2s3s4s5s6s7s8s9s10s11s12s13s14s15sDefault: "5s"
multi_shotsOptional: Split the video into several scenes. Wan 2.6 and 2.7 only.
Type: BooleanDefault: false
audioOptional: Your own sound for the video, such as a voice or music: one URL. Available in Wan 2.6 and 2.7. Sound longer than the video is cut to its length.
Type: List (String, uri)Maximum items: 1

Parameters not listed here are not accepted: the response is 422 unknown_setting.

Input

Frames are URLs of JPEG, PNG or WebP files up to 10 MB each.
Sound is a URL of an MP3 or WAV file up to 10 MB.

Field	Accepts	Formats	Files	File size up to
`image_urls`	Images	jpeg, jpg, png, webp	2	10 MB
`audio`	Audio	mp3, wav	1	10 MB

How to send files

Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

A frame that speaks in your voice

JSON

{
  "model": "wan",
  "settings": {
    "mode": "frames",
    "model": "2_7",
    "prompt": "Лев смотрит в камеру и говорит этим голосом",
    "image_urls": [
      "https://example.com/lion.jpg"
    ],
    "audio": [
      "https://example.com/voice.mp3"
    ],
    "duration": "5s"
  }
}

The price is calculated when the task is accepted, currency RUB.

Complete generation example

Output

One MP4 video.
Generation usually takes 5 to 10 minutes.

Kind	Formats	How many	Note
`video`	mp4	1

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

How to read the result and download files

From references

Characters, objects and places from your pictures and videos in a new video. Versions 2.7 and 3.0.

Value of the mode field: reference

This page is about Wan 2.7: send model = 2_7. Without the model field the task runs on 3_0.

Price in this mode from 24 ₽, with a 1 s file.

Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

promptRequired: What happens in the video. Refer to the attachments by the labels @Image1, @Video1, each one must be mentioned. Up to 5,000 characters, up to 20,000 for Wan 3.0.
Type: StringMinimum characters: 1Maximum characters: 20000
ref_image_urlsOptional: Pictures with characters, objects or a place, @Image1, @Image2 in the prompt in the order of the URLs. Up to 5 pictures and videos together, at least one of them is required.
Type: List (String, uri)Maximum items: 5
ref_video_urlsOptional: Videos with a character, @Video1, @Video2 in the prompt. Each is 1 to 5 seconds, their seconds are included in the price. With a video, Wan 2.7 makes a video of 10 seconds at most.
Type: List (String, uri)Maximum items: 5
first_frame_urlOptional: The first frame of the video, optional. With it the video takes the shape of the frame, and aspect_ratio has no effect.
Type: List (String, uri)Maximum items: 1
modelOptional: Wan version: 2.7 or 3.0.
Type: StringAllowed values: 2_7Default: "3_0"
qualityOptional: Video resolution; the set depends on the version. The price per second depends on it.
Type: StringAllowed values: 720p1080pDefault: "720p"
aspect_ratioOptional: Frame shape.
Type: StringAllowed values: 16:99:161:14:33:4The set depends on quality.Default: "16:9"
durationOptional: Video length: 2 to 15 seconds for Wan 2.7, up to 10 with a video among the attachments; 2 to 30 for 3.0. The price is per second.
Type: StringAllowed values: 2s3s4s5s6s7s8s9s10s11s12s13s14s15sDefault: "5s"
multi_shotsOptional: Split the video into several scenes. Wan 2.7 only.
Type: BooleanDefault: false

Parameters not listed here are not accepted: the response is 422 unknown_setting.

Input

Every attachment must be mentioned in the prompt by its label: @Image1, @Image2, @Video1 and so on. The number is the position of the URL in the field of its type. Write it exactly like this: capital letter, no space.
Pictures are URLs of JPEG, PNG or WebP files up to 10 MB each, videos are URLs of MP4 or MOV files up to 100 MB.
A video goes to the model whole, without trimming, and its seconds are included in the price.

Field	Accepts	Formats	Files	File size up to
`ref_image_urls`	Images	jpeg, jpg, png, webp	5	10 MB
`ref_video_urls`	Video	mp4, mov	5	100 MB
`first_frame_url`	Images	jpeg, jpg, png, webp	1	10 MB

How to send files

Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Two characters and a first frame

JSON

{
  "model": "wan",
  "settings": {
    "mode": "reference",
    "model": "2_7",
    "prompt": "@Image1 встречает @Video1 у входа в кафе и машет рукой",
    "ref_image_urls": [
      "https://example.com/hero.png"
    ],
    "ref_video_urls": [
      "https://example.com/friend.mp4"
    ],
    "first_frame_url": [
      "https://example.com/cafe.jpg"
    ],
    "duration": "5s"
  }
}

The price is calculated when the task is accepted, currency RUB.

Complete generation example

Output

One MP4 video.
Generation usually takes 5 to 10 minutes.

Kind	Formats	How many	Note
`video`	mp4	1

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

How to read the result and download files

Try Wan 2.7 through the API

One key opens every CyHUB model. Payment in rubles, and you see the price before the run.

Get an API key

Wan 2.7 API

Connect in three steps

Ready-to-use code

Price before the run

Modes

From a prompt

Parameters

Input

Request example

Output

From frames

Parameters

Input

Request example

Output

From references

Parameters

Input

Request example

Output

See also

Try Wan 2.7 through the API