Wan 2.5 API
Alibaba Wan 2.5 — text-to-video và image-to-video tới 1080p với âm thanh đồng bộ, cùng video-extend, image-edit và text-to-image trong cùng dòng, với các biến thể Fast cho endpoint video.
Hướng dẫn Wan 2.5 API này giới thiệu các endpoint đang hoạt động trên WaveSpeedAI: text-to-video, image-to-video và video-extend với biến thể Fast, image-edit và text-to-image. Playground, ví dụ, bảng giá và mẫu API bên dưới đều dùng các endpoint Wan 2.5 đang hoạt động.
Tổng quan
Giới thiệu về Wan 2.5 API
Wan 2.5 làm được gì, nằm ở đâu trong dòng mô hình của Alibaba, và vì sao các đội ngũ chọn nó.
Wan 2.5 là mô hình tạo video từ Alibaba, có sẵn qua REST API của WaveSpeedAI. Alibaba Wan 2.5 — text-to-video và image-to-video tới 1080p với âm thanh đồng bộ, cùng video-extend, image-edit và text-to-image trong cùng dòng, với các biến thể Fast cho endpoint video.
Hướng dẫn Wan 2.5 API này giới thiệu các endpoint đang hoạt động trên WaveSpeedAI: text-to-video, image-to-video và video-extend với biến thể Fast, image-edit và text-to-image. Playground, ví dụ, bảng giá và mẫu API bên dưới đều dùng các endpoint Wan 2.5 đang hoạt động.
Họ Wan 2.5 trên WaveSpeedAI cung cấp 8 endpoint REST bao gồm 5 quy trình Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Mỗi biến thể có giá, các tham số điều chỉnh và kết quả mẫu riêng — hãy chọn biến thể phù hợp với dạng đầu vào và ràng buộc sản xuất của bạn, hoặc gọi nhiều biến thể từ cùng một API key để ghép các pipeline nhiều bước.
Chạy Wan 2.5 bằng cùng API key, tài khoản thanh toán và hạn mức tốc độ bạn dùng cho hơn 1.000 mô hình AI khác trên WaveSpeedAI. Không cần thiết lập nhà cung cấp riêng, không cần SDK cho từng nhà cung cấp, không có hạn mức tốc độ riêng của từng hãng — một lần tích hợp bao quát mọi thứ, từ text-to-image và text-to-video đến tổng hợp âm thanh, tạo 3D, nâng cấp và chỉnh sửa.
Thông số
Khả năng và trạng thái phát hành của Wan 2.5 API
Các chi tiết riêng của mô hình mà nhà phát triển tìm kiếm trước khi chọn API: tình trạng khả dụng, độ dài đầu ra dự kiến, hỗ trợ tham chiếu và phương án thay thế đang hoạt động.
Tình trạng
Đang hoạt động
Các endpoint Wan 2.5 đang hoạt động trong danh mục WaveSpeedAI: text-to-video, image-to-video và video-extend (mỗi loại có một biến thể Fast), image-edit và text-to-image, tất cả trên cùng luồng prediction REST.
Độ phân giải
480p, 720p, 1080p
Đầu ra video có ở 480p, 720p và 1080p tùy endpoint; text-to-video có kích thước ngang và dọc ở mỗi mức.
Thời lượng
3 đến 10 giây
Text-to-video tạo clip 5 hoặc 10 giây; image-to-video Fast và video-extend tạo clip 3 đến 10 giây.
Âm thanh
Âm thanh đồng bộ
Các endpoint video tạo âm thanh đồng bộ với hình ảnh, và một tệp âm thanh tùy chọn (WAV hoặc MP3, tối thiểu 3 giây, tối đa 15 MB) có thể định hướng kết quả.
Biến thể Fast
Text, image và extend
Wan 2.5 Fast có cho text-to-video, image-to-video và video-extend, được định vị cho việc tạo nhanh hơn và rẻ hơn.
Công cụ ảnh
Edit và text-to-image
image-edit nhận tối đa hai ảnh đầu vào cùng prompt, còn text-to-image tạo ảnh tĩnh trong cùng dòng với các endpoint video.
Endpoint
Tất cả endpoint API Wan 2.5
8 endpoint Wan 2.5 hiện có sẵn trên WaveSpeedAI — hãy chọn biến thể phù hợp với quy trình của bạn.
/filters:quality(82)/media/images/20260408104220_jymu91ex.webp)
Wan 2.5 Image Edit
Refine existing visuals with WAN 2.5 image-edit using prompt-driven adjustments and stylistic upgrades for photos and graphics. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104211_97h9m7p7.webp)
Wan 2.5 Text To Image
WAN 2.5 Text-to-Image turns text prompts into AI-generated images with the WAN 2.5 model for on-demand image creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104203_64hpvi1b.webp)
Wan 2.5 Video Extend Fast
WAN 2.5 Fast is an AI-powered video extender that turns short clips into longer videos while preserving audio tracks for seamless extensions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104158_jzbs7q2h.webp)
Wan 2.5 Video Extend
WAN 2.5 Video-Extend turns short clips into longer videos with preserved or generated synchronized audio for continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104214_334vajy7.webp)
Wan 2.5 Text To Video
WAN 2.5 makes 480p-1080p text/image-to-video with synced audio and is faster, more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104222_y5iz96kb.webp)
Wan 2.5 Text To Video Fast
WAN 2.5 Fast creates synchronized-audio videos from text or images in 720p, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104205_99s4gqxu.webp)
Wan 2.5 Image To Video Fast
WAN 2.5 Fast converts text or images into synchronized-audio videos in 480p, 720p, or 1080p, offering faster, more affordable generation compared to Google Veo3. REST API, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408104159_4c1hr4ym.webp)
Wan 2.5 Image To Video
WAN 2.5 converts text or images into videos (480p/720p/1080p) with synced audio, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Ví dụ
Xem Wan 2.5 hoạt động
Kết quả thật do API Wan 2.5 tạo ra. Rê chuột lên video để xem trước, nhấp để mở trình xem kích thước đầy đủ.
Hướng dẫn
Cách dùng API Wan 2.5
Bốn bước từ đăng ký đến khi có kết quả. Ví dụ đầy đủ bằng Python, Node.js và cURL nằm ở phần API bên dưới.
- 01
Lấy API key
Đăng ký tài khoản WaveSpeedAI và sao chép API key từ bảng điều khiển. Tài khoản mới được tặng credit dùng thử miễn phí — đủ để chạy playground vài chục lần trước khi bắt đầu tính phí.
- 02
Gửi một prediction
POST đầu vào của bạn dưới dạng JSON tới https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. Endpoint trả về prediction id ngay lập tức — việc tạo là bất đồng bộ nên bạn không phải giữ kết nối mở trong lúc suy luận.
- 03
Poll để chờ hoàn tất
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Trả về kết quả khi completed; dừng và báo lỗi khi failed, cancelled, timeout hoặc deleted; tiếp tục poll với mọi trạng thái khác.
- 04
Đọc URL kết quả
Khi status là "completed", đọc URL từ data.outputs[0]. URL trỏ tới media bạn đã tạo trên CDN của WaveSpeedAI — ảnh, video, âm thanh hoặc tệp 3D tùy biến thể Wan 2.5 bạn đã gọi.
Trường hợp sử dụng
Bạn có thể xây dựng gì với Wan 2.5
Các quy trình phổ biến mà nhà phát triển và người sáng tạo dùng API Wan 2.5 cho.
Text-to-video với âm thanh đồng bộ
alibaba/wan-2.5/text-to-video biến một prompt thành clip 5 hoặc 10 giây ở tối đa 1080p, với âm thanh được tạo cùng hình ảnh.
Image-to-video từ ảnh tĩnh
alibaba/wan-2.5/image-to-video và biến thể Fast làm động một ảnh tham chiếu bằng prompt, ở 720p hoặc 1080p và 3 đến 10 giây trên endpoint Fast.
Kéo dài một clip
alibaba/wan-2.5/video-extend tiếp nối một video có sẵn với âm thanh đồng bộ được giữ lại hoặc tạo mới, ở 480p, 720p hoặc 1080p, và biến thể Fast làm tương tự với chi phí thấp hơn.
Dẫn dắt clip bằng âm thanh của bạn
Truyền một tệp âm thanh vào các endpoint video để định hướng kết quả, ví dụ một câu thoại hoặc một nhịp mà chuyển động cần bám theo.
Chỉnh sửa ảnh trong cùng dòng mô hình
alibaba/wan-2.5/image-edit áp dụng chỉnh sửa theo prompt cho một hoặc hai ảnh, nên ảnh tĩnh và clip đều đến từ cùng một dòng mô hình.
Ảnh tĩnh với text-to-image
alibaba/wan-2.5/text-to-image tạo ảnh từ prompt, với kích thước đặt theo pixel tới 2880.
Mẹo
Mẹo viết prompt cho Wan 2.5
Lời khuyên thực tế để có kết quả tốt hơn từ Wan 2.5 — rút ra từ các mẫu hiệu quả trên các mô hình video trong các pipeline sản xuất.
- 01
Làm mẫu trên Fast, bàn giao trên endpoint tiêu chuẩn
Dùng các biến thể Fast để thử prompt và chuyển động, rồi chạy endpoint tiêu chuẩn cho clip cuối cùng.
- 02
Chọn kích thước theo nền tảng
Text-to-video có kích thước ngang và dọc ở 480p, 720p và 1080p, nên hãy chọn kích thước theo nơi clip sẽ phát trước khi tạo.
- 03
Dùng âm thanh để định hướng nhịp
Một tệp WAV hoặc MP3 ngắn tối thiểu 3 giây có thể định hướng kết quả, hữu ích khi chuyển động cần bám theo một câu thoại hoặc một nhịp.
- 04
Kéo dài từng bước nhỏ
Với video-extend, hãy nối dài clip vài giây mỗi lần và mô tả điều xảy ra tiếp theo, để mỗi bước giữ cho cảnh và âm thanh liền mạch.
Giá
Giá API Wan 2.5
Giá tính theo từng kết quả đầu ra. Khoản phí cuối cùng thay đổi theo các tham số bạn đặt trong playground của từng biến thể (độ phân giải, thời lượng, số kết quả, tham chiếu).
| Endpoint | Loại | Giá khởi điểm |
|---|---|---|
| alibaba/ | image-to-image | $0.035 |
| alibaba/ | text-to-image | $0.03 |
| alibaba/ | video-extend | $0.068 |
| alibaba/ | video-extend | $0.10 |
| alibaba/ | text-to-video | $0.10 |
| alibaba/ | text-to-video | $0.068 |
| alibaba/ | image-to-video | $0.068 |
| alibaba/ | image-to-video | $0.10 |
API
Gọi API Wan 2.5
Đăng ký API key tại wavespeed.ai/accesskey, rồi gửi prediction qua REST. Playground tạo sẵn mã mẫu có thể dán ngay cho mọi tổ hợp đầu vào.
POSThttps://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"size": "1280*720",
"duration": 5,
"enable_prompt_expansion": False
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)So sánh
Wan 2.5 so với các lựa chọn khác
Khi nào nên chọn Wan 2.5 thay vì các mô hình tương tự trên WaveSpeedAI.
Wan 2.5 so với Wan 2.7
Wan 2.7 là thế hệ mới hơn với reference-to-video, video-edit và đầu ra 1080p trên nhiều endpoint hơn. Wan 2.5 vẫn là một lựa chọn với các biến thể Fast và âm thanh đồng bộ.
Wan 2.5 so với Veo 3.1
Danh mục định vị Wan 2.5 nhanh hơn và rẻ hơn Google Veo 3, với tạo video theo âm thanh và video-extend. Veo 3.1 có các bậc Standard, Fast và Lite ở 1080p.
Wan 2.5 so với Kling 2.6
Kling 2.6 bổ sung endpoint motion-control và create-voice. Wan 2.5 bao phủ 480p đến 1080p với âm thanh đồng bộ, video-extend, image-edit và text-to-image trong một dòng.
Câu hỏi thường gặp
Wan 2.5 API — Câu hỏi thường gặp
Giá, giấy phép, tích hợp — những câu hỏi phổ biến về việc chạy Wan 2.5 trên WaveSpeedAI.
Wan 2.5 hỗ trợ những độ phân giải nào?
Các endpoint video xuất 480p, 720p và 1080p tùy endpoint. Text-to-video còn có kích thước dọc, và image-to-video Fast xuất 720p hoặc 1080p.
Wan 2.5 có tạo âm thanh không?
Có. Các endpoint video tạo âm thanh đồng bộ với hình ảnh, và bạn có thể gửi thêm một tệp âm thanh tùy chọn để định hướng kết quả.
Wan 2.5 Fast là gì?
Các biến thể Fast của text-to-video, image-to-video và video-extend, được định vị để tạo nhanh hơn và rẻ hơn so với các biến thể tiêu chuẩn.
Tôi có thể kéo dài một video có sẵn bằng Wan 2.5 không?
Có. Endpoint video-extend nối dài một clip ngắn thành clip dài hơn, với âm thanh đồng bộ được giữ lại hoặc tạo mới, và có biến thể Fast.
API Wan 2.5 là gì?
Wan 2.5 là mô hình tạo video của Alibaba, được cung cấp dưới dạng REST API trên WaveSpeedAI. Alibaba Wan 2.5 — text-to-video và image-to-video tới 1080p với âm thanh đồng bộ, cùng video-extend, image-edit và text-to-image trong cùng dòng, với các biến thể Fast cho endpoint video. Bạn có thể gọi bằng lập trình hoặc thử từ playground ở liên kết phía trên.
Làm sao để gọi API Wan 2.5?
Đăng ký tài khoản WaveSpeedAI, sao chép API key từ /accesskey, rồi POST tới https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video với đầu vào dưới dạng JSON. Endpoint trả về prediction id. Hãy poll endpoint kết quả khoảng mỗi 2 giây, tăng khoảng cách với các tác vụ chạy lâu, và dừng ở bất kỳ trạng thái kết thúc nào. Ví dụ Python / Node.js / cURL hướng tới môi trường production ở phía trên.
API Wan 2.5 có giá bao nhiêu?
Wan 2.5 bắt đầu từ $0.03 mỗi lượt chạy. Chi phí chính xác thay đổi theo các tham số bạn đặt (độ phân giải, thời lượng, số kết quả, tham chiếu). Phần xem trước chi phí trực tiếp cạnh nút Tạo trong playground hiển thị giá chính xác cho đầu vào hiện tại của bạn.
Có những biến thể Wan 2.5 nào?
WaveSpeedAI cung cấp 8 endpoint Wan 2.5 đang hoạt động: alibaba/wan-2.5/image-edit, alibaba/wan-2.5/text-to-image, alibaba/wan-2.5/video-extend-fast, alibaba/wan-2.5/video-extend, alibaba/wan-2.5/text-to-video, alibaba/wan-2.5/text-to-video-fast, alibaba/wan-2.5/image-to-video-fast, alibaba/wan-2.5/image-to-video. Mỗi biến thể có trang playground và giá riêng.
Tôi có thể dùng kết quả của Wan 2.5 cho mục đích thương mại không?
Quyền sử dụng thương mại tuân theo giấy phép mô hình của Alibaba. Hầu hết mô hình của Alibaba cho phép dùng kết quả đầu ra cho mục đích thương mại; hãy xem trang playground của từng mô hình để biết tóm tắt giấy phép cụ thể, và Điều khoản dịch vụ của WaveSpeedAI cho các điều kiện cấp nền tảng.
Tại sao dùng Wan 2.5 trên WaveSpeedAI thay vì gọi trực tiếp?
Một API key + một tài khoản thanh toán cho Wan 2.5 VÀ hơn 1.000 mô hình AI khác từ các nhà cung cấp khác. Không cần thiết lập SDK cho từng hãng, không có hạn mức tốc độ riêng, không phải viết lại mã tích hợp cho từng hãng. Giá thường ngang bằng hoặc thấp hơn API trực tiếp của Alibaba.
Nhà cung cấp
Giới thiệu về Alibaba
Đội ngũ đứng sau Wan 2.5 và dòng mô hình Alibaba rộng hơn trên WaveSpeedAI.
Tongyi Lab của Alibaba tạo ra dòng mô hình video Wan và dòng LLM Qwen. Wan nổi bật nhờ được phát hành với trọng số mở, phủ nhiều biến thể (text-to-video, image-to-video, reference-to-video, video-edit, video-extend, image-edit, text-to-image) và luôn mạnh về độ ổn định chuyển động cũng như khả năng bám sát prompt với các prompt đa ngôn ngữ.
Bắt đầu xây dựng với Wan 2.5 trên WaveSpeedAI
Tặng credit dùng thử miễn phí khi đăng ký. Một API key cho hơn 1.000 mô hình AI từ Alibaba và mọi nhà cung cấp khác.