Wan 2.5 API
Alibaba Wan 2.5 — 동기화된 오디오와 함께 최대 1080p를 지원하는 텍스트-투-비디오와 이미지-투-비디오, 그리고 같은 패밀리의 video-extend, image-edit, text-to-image를 제공하며, 비디오 엔드포인트에는 Fast 변형도 있습니다.
이 Wan 2.5 API 가이드는 WaveSpeedAI에서 제공 중인 엔드포인트인 Fast 변형이 있는 텍스트-투-비디오, 이미지-투-비디오, video-extend와 image-edit, text-to-image를 다룹니다. 아래의 플레이그라운드, 예제, 가격, API 샘플은 모두 제공 중인 Wan 2.5 엔드포인트를 사용합니다.
개요
Wan 2.5 API 소개
Wan 2.5의 기능, Alibaba 모델 라인업에서의 위치, 그리고 팀들이 이 모델을 선택하는 이유.
Alibaba의 비디오 생성 모델 Wan 2.5. WaveSpeedAI REST API로 바로 사용할 수 있습니다. Alibaba Wan 2.5 — 동기화된 오디오와 함께 최대 1080p를 지원하는 텍스트-투-비디오와 이미지-투-비디오, 그리고 같은 패밀리의 video-extend, image-edit, text-to-image를 제공하며, 비디오 엔드포인트에는 Fast 변형도 있습니다.
이 Wan 2.5 API 가이드는 WaveSpeedAI에서 제공 중인 엔드포인트인 Fast 변형이 있는 텍스트-투-비디오, 이미지-투-비디오, video-extend와 image-edit, text-to-image를 다룹니다. 아래의 플레이그라운드, 예제, 가격, API 샘플은 모두 제공 중인 Wan 2.5 엔드포인트를 사용합니다.
WaveSpeedAI의 Wan 2.5 제품군은 Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video 워크플로를 아우르는 REST 엔드포인트 8개를 제공합니다. 각 변형은 고유한 가격, 파라미터, 예시 출력을 갖고 있으니 입력 방식과 운영 조건에 맞는 것을 고르거나, 같은 API 키로 여러 개를 호출해 다단계 파이프라인을 구성하세요.
Wan 2.5 실행에도 WaveSpeedAI의 다른 1,000개 이상의 AI 모델과 같은 API 키, 결제 계정, 요청 한도 체계를 그대로 사용합니다. 별도의 벤더 설정도, 제공사별 SDK도, 벤더별 요청 한도 체계도 필요 없습니다. 하나의 연동으로 텍스트 → 이미지, 텍스트 → 비디오부터 오디오 합성, 3D 생성, 업스케일링, 편집까지 모두 지원합니다.
사양
Wan 2.5 API 기능 및 출시 현황
API를 고르기 전에 개발자가 찾아보는 모델별 세부 정보입니다. 제공 여부, 예상 출력 길이, 레퍼런스 지원, 현재 사용 가능한 대체 모델을 담았습니다.
제공 상태
지금 이용 가능
Wan 2.5 엔드포인트는 WaveSpeedAI 카탈로그에서 제공 중입니다. text-to-video, image-to-video, video-extend(각각 Fast 변형 포함), image-edit, text-to-image를 모두 같은 REST 예측 흐름으로 이용할 수 있습니다.
해상도
480p, 720p, 1080p
비디오 출력은 엔드포인트에 따라 480p, 720p, 1080p로 제공됩니다. 텍스트-투-비디오는 각 해상도에서 가로 및 세로 크기를 제공합니다.
길이
3~10초
텍스트-투-비디오는 5초 또는 10초 클립을 생성하고, 이미지-투-비디오 Fast와 video-extend는 3~10초를 생성합니다.
오디오
동기화된 오디오
비디오 엔드포인트는 영상과 동기화된 오디오를 생성하며, 선택형 오디오 파일(WAV 또는 MP3, 3초 이상, 최대 15 MB)로 생성을 유도할 수 있습니다.
Fast 변형
텍스트, 이미지, 연장
Wan 2.5 Fast는 텍스트-투-비디오, 이미지-투-비디오, video-extend에서 사용할 수 있으며, 더 빠르고 저렴한 생성을 위한 변형입니다.
이미지 도구
편집 및 text-to-image
image-edit는 프롬프트와 함께 최대 두 장의 입력 이미지를 받고, text-to-image는 비디오 엔드포인트와 같은 패밀리에서 스틸을 생성합니다.
엔드포인트
Wan 2.5 API 전체 엔드포인트
Wan 2.5 엔드포인트 8개를 지금 WaveSpeedAI에서 사용할 수 있습니다. 워크플로에 맞는 변형을 고르세요.
/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.
예시
Wan 2.5 활용 예시
Wan 2.5 API로 생성한 실제 출력물입니다. 비디오 위에 마우스를 올리면 미리 보고, 클릭하면 전체 크기 뷰어가 열립니다.
사용 방법
Wan 2.5 API 사용 방법
가입부터 결과물 생성까지 네 단계입니다. Python, Node.js, cURL 전체 예시는 아래 API 섹션에 있습니다.
- 01
API 키 받기
WaveSpeedAI 계정을 만들고 대시보드에서 API 키를 복사하세요. 신규 계정에는 무료 스타터 크레딧이 제공되어, 요금이 청구되기 전에 Playground를 수십 번 실행해 볼 수 있습니다.
- 02
Prediction 제출
입력을 JSON으로 https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video에 POST하세요. 엔드포인트가 prediction id를 즉시 반환합니다. 생성은 비동기로 처리되므로 추론 중에 연결을 계속 열어 둘 필요가 없습니다.
- 03
완료될 때까지 폴링
https://api.wavespeed.ai/api/v3/predictions/{request_id}/result로 GET 요청을 보내세요. completed이면 outputs를 반환하고, failed, cancelled, timeout, deleted이면 오류로 종료하며, 그 밖의 모든 status에서는 폴링을 계속합니다.
- 04
출력 URL 읽기
status가 "completed"가 되면 data.outputs[0]에서 URL을 읽으세요. 이 URL은 WaveSpeedAI CDN에 있는 생성된 미디어를 가리키며, 호출한 Wan 2.5 변형에 따라 이미지, 비디오, 오디오 또는 3D 파일입니다.
활용 사례
Wan 2.5 활용 사례
개발자와 크리에이터가 Wan 2.5 API를 사용하는 대표적인 워크플로입니다.
동기화된 오디오를 갖춘 텍스트-투-비디오
alibaba/wan-2.5/text-to-video는 프롬프트를 영상과 함께 생성된 오디오가 포함된, 최대 1080p의 5초 또는 10초 클립으로 바꿉니다.
정지 이미지에서 시작하는 이미지-투-비디오
alibaba/wan-2.5/image-to-video와 Fast 변형은 프롬프트로 레퍼런스 이미지에 움직임을 줍니다. 720p 또는 1080p를 지원하며, Fast 엔드포인트에서는 3~10초입니다.
클립 연장
alibaba/wan-2.5/video-extend는 기존 비디오를 유지되거나 새로 생성된 동기화 오디오와 함께 이어 갑니다. 480p, 720p, 1080p를 지원하며, Fast 변형은 더 낮은 비용으로 같은 작업을 합니다.
내 오디오로 클립 유도하기
비디오 엔드포인트에 오디오 파일을 전달해 생성을 유도할 수 있습니다. 예를 들어 모션이 따라야 하는 대사나 비트가 있습니다.
같은 패밀리에서 이미지 편집
alibaba/wan-2.5/image-edit는 한 장 또는 두 장의 이미지에 프롬프트 기반 편집을 적용하므로, 스틸과 클립을 하나의 모델 패밀리에서 만들 수 있습니다.
text-to-image로 만드는 스틸
alibaba/wan-2.5/text-to-image는 프롬프트로 이미지를 생성하며, 크기는 픽셀 단위로 최대 2880까지 지정할 수 있습니다.
팁
Wan 2.5 프롬프트 작성 팁
Wan 2.5에서 더 나은 결과를 얻기 위한 실용적인 조언입니다. 운영 파이프라인에서 비디오 모델 전반에 통하는 패턴을 바탕으로 했습니다.
- 01
Fast로 프로토타입을 만들고 표준 엔드포인트로 마무리하세요
Fast 변형으로 프롬프트와 모션을 테스트한 뒤, 최종 클립은 표준 엔드포인트로 실행하세요.
- 02
플랫폼에 맞는 크기를 고르세요
텍스트-투-비디오는 480p, 720p, 1080p에서 가로 및 세로 크기를 제공합니다. 생성하기 전에 클립이 재생될 곳에 맞는 크기를 고르세요.
- 03
오디오로 타이밍을 이끄세요
3초 이상의 짧은 WAV 또는 MP3로 생성을 유도할 수 있으며, 모션이 대사나 비트를 따라야 할 때 도움이 됩니다.
- 04
조금씩 나누어 연장하세요
video-extend에서는 한 번에 몇 초씩 클립을 이어 가며 다음에 일어날 일을 묘사하세요. 그러면 각 단계에서 장면과 오디오가 자연스럽게 이어집니다.
가격
Wan 2.5 API 가격
가격은 출력당 책정됩니다. 최종 요금은 각 변형의 Playground에서 설정한 파라미터(해상도, 길이, 출력 수, 레퍼런스)에 따라 달라집니다.
| 엔드포인트 | 유형 | 시작 가격 |
|---|---|---|
| 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
Wan 2.5 API 호출하기
wavespeed.ai/accesskey에서 API 키를 발급받은 뒤 REST로 prediction을 제출하세요. Playground에서 입력 조합별로 바로 붙여넣을 수 있는 샘플이 생성됩니다.
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)비교
Wan 2.5 vs 대안
비슷한 WaveSpeedAI 모델과 비교한 Wan 2.5의 선택 기준.
Wan 2.5 vs Wan 2.7
Wan 2.7은 레퍼런스-투-비디오, video-edit, 더 많은 엔드포인트의 1080p 출력을 갖춘 최신 세대입니다. Wan 2.5는 Fast 변형과 동기화된 오디오를 쓰고 싶을 때 여전히 선택할 수 있습니다.
Wan 2.5 vs Veo 3.1
카탈로그에서는 Wan 2.5를 오디오 유도 생성과 video-extend를 갖춘, Google Veo 3보다 빠르고 저렴한 모델로 소개합니다. Veo 3.1은 1080p에서 Standard, Fast, Lite 등급을 제공합니다.
Wan 2.5 vs Kling 2.6
Kling 2.6은 모션 컨트롤과 create-voice 엔드포인트를 추가합니다. Wan 2.5는 동기화된 오디오와 함께 480p~1080p, video-extend, image-edit, text-to-image를 한 패밀리에서 다룹니다.
FAQ
Wan 2.5 API — 자주 묻는 질문
가격, 라이선스, 연동 — WaveSpeedAI에서 Wan 2.5 실행에 관한 자주 묻는 질문.
Wan 2.5는 어떤 해상도를 지원하나요?
비디오 엔드포인트는 엔드포인트에 따라 480p, 720p, 1080p로 출력합니다. 텍스트-투-비디오는 세로 크기도 제공하며, 이미지-투-비디오 Fast는 720p 또는 1080p로 출력합니다.
Wan 2.5는 오디오를 생성하나요?
네. 비디오 엔드포인트는 영상과 동기화된 오디오를 생성하며, 선택형 오디오 파일을 보내 결과를 유도할 수도 있습니다.
Wan 2.5 Fast란 무엇인가요?
텍스트-투-비디오, 이미지-투-비디오, video-extend의 Fast 변형으로, 표준 변형보다 빠르고 저렴한 생성을 위한 것입니다.
Wan 2.5로 기존 비디오를 연장할 수 있나요?
네. video-extend 엔드포인트는 짧은 클립을 더 긴 클립으로 이어 주며, 유지되거나 새로 생성된 동기화 오디오를 붙일 수 있습니다. Fast 변형도 있습니다.
Wan 2.5 API란 무엇인가요?
Wan 2.5 — WaveSpeedAI에서 REST API로 제공되는 Alibaba의 비디오 생성 모델입니다. Alibaba Wan 2.5 — 동기화된 오디오와 함께 최대 1080p를 지원하는 텍스트-투-비디오와 이미지-투-비디오, 그리고 같은 패밀리의 video-extend, image-edit, text-to-image를 제공하며, 비디오 엔드포인트에는 Fast 변형도 있습니다. 프로그래밍 방식으로 호출하거나 위에 링크된 Playground에서 체험해 볼 수 있습니다.
Wan 2.5 API는 어떻게 호출하나요?
WaveSpeedAI 계정을 만들고 /accesskey에서 API 키를 복사한 뒤, 입력을 JSON으로 https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video에 POST하세요. 엔드포인트가 prediction id를 반환합니다. 결과 엔드포인트 폴링은 약 2초마다 시작하고, 오래 걸리는 작업은 간격을 늘리며, 종료 status가 나오면 중단하세요. 운영 환경용 Python / Node.js / cURL 예시는 위에 있습니다.
Wan 2.5 API 요금은 얼마인가요?
Wan 2.5의 가격은 회당 $0.03부터입니다. 정확한 비용은 설정한 파라미터(해상도, 길이, 출력 수, 레퍼런스)에 따라 달라집니다. Playground의 생성 버튼 옆 실시간 비용 미리보기에서 현재 입력 기준의 정확한 가격을 확인할 수 있습니다.
Wan 2.5에는 어떤 변형이 있나요?
WaveSpeedAI에는 라이브 Wan 2.5 엔드포인트가 8개 있습니다: 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. 각 변형에는 고유한 Playground 페이지와 가격이 있습니다.
Wan 2.5 출력물을 상업적으로 사용할 수 있나요?
상업적 사용 권한은 Alibaba 모델 라이선스를 따릅니다. 대부분의 Alibaba 모델은 출력물의 상업적 사용을 허용합니다. 구체적인 라이선스 요약은 각 모델의 Playground 페이지를, 플랫폼 수준의 조건은 WaveSpeedAI 이용약관을 참고하세요.
직접 연동하지 않고 WaveSpeedAI에서 Wan 2.5 모델을 사용하는 이유는 무엇인가요?
API 키 하나와 결제 계정 하나로 Wan 2.5 모델과 다른 제공사의 1,000개 이상의 AI 모델을 모두 사용합니다. 벤더별 SDK 설정도, 별도의 요청 한도 체계도, 벤더마다 연동 코드를 다시 쓸 일도 없습니다. 가격은 대체로 Alibaba의 직접 API와 같거나 더 저렴합니다.
제공사
Alibaba 소개
WaveSpeedAI의 Wan 2.5 및 Alibaba 전체 모델 라인업을 만든 팀.
Alibaba의 Tongyi Lab은 Wan 비디오 모델 패밀리와 Qwen LLM 패밀리를 만듭니다. Wan은 오픈 웨이트로 공개되었고, 폭넓은 변형(텍스트-투-비디오, 이미지-투-비디오, 레퍼런스-투-비디오, video-edit, video-extend, image-edit, 텍스트-투-이미지)을 갖추었으며, 다국어 프롬프트 전반에서 모션 안정성과 프롬프트 반영이 꾸준히 강한 점이 특징입니다.
WaveSpeedAI에서 Wan 2.5 시작하기
가입 시 무료 스타터 크레딧 제공. Alibaba 및 다른 모든 제공사의 1,000개 이상 AI 모델을 API 키 하나로.