Wan 2.5 API
Alibaba Wan 2.5 — texto para vídeo e imagem para vídeo em até 1080p com áudio sincronizado, além de video-extend, image-edit e text-to-image na mesma família, com variantes Fast dos endpoints de vídeo.
Este guia da API Wan 2.5 cobre os endpoints ativos na WaveSpeedAI: texto para vídeo, imagem para vídeo e video-extend com variantes Fast, image-edit e text-to-image. O playground, os exemplos, os preços e as amostras de API abaixo usam os endpoints ativos do Wan 2.5.
Visão geral
Sobre o Wan 2.5 API
O que o Wan 2.5 faz, como ele se encaixa na linha de modelos da Alibaba e por que as equipes o escolhem.
Wan 2.5 é um modelo de geração de vídeo da Alibaba, disponível pela API REST da WaveSpeedAI. Alibaba Wan 2.5 — texto para vídeo e imagem para vídeo em até 1080p com áudio sincronizado, além de video-extend, image-edit e text-to-image na mesma família, com variantes Fast dos endpoints de vídeo.
Este guia da API Wan 2.5 cobre os endpoints ativos na WaveSpeedAI: texto para vídeo, imagem para vídeo e video-extend com variantes Fast, image-edit e text-to-image. O playground, os exemplos, os preços e as amostras de API abaixo usam os endpoints ativos do Wan 2.5.
A família Wan 2.5 na WaveSpeedAI traz 8 endpoints REST cobrindo os fluxos de Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video. Cada variante tem seu próprio preço, parâmetros e exemplos de resultado — escolha a que combina com sua modalidade de entrada e suas restrições de produção, ou chame várias com a mesma chave de API para montar pipelines de várias etapas.
Execute o Wan 2.5 com a mesma chave de API, a mesma conta de cobrança e os mesmos limites de taxa que você usa nos outros mais de 1.000 modelos de IA da WaveSpeedAI. Sem configuração separada por fornecedor, sem SDKs por provedor, sem limites de taxa por fornecedor — uma única integração cobre tudo, de texto para imagem e texto para vídeo até síntese de áudio, geração 3D, ampliação e edição.
Especificações
Recursos e status de lançamento do Wan 2.5 API
Os detalhes específicos do modelo que desenvolvedores procuram antes de escolher uma API: disponibilidade, duração esperada do resultado, suporte a referências e a alternativa ativa atual.
Disponibilidade
Disponível agora
Os endpoints do Wan 2.5 estão ativos no catálogo da WaveSpeedAI: texto para vídeo, imagem para vídeo e video-extend (cada um com uma variante Fast), image-edit e text-to-image, todos no mesmo fluxo de predictions REST.
Resoluções
480p, 720p, 1080p
A saída de vídeo está disponível em 480p, 720p e 1080p, conforme o endpoint; texto para vídeo oferece tamanhos paisagem e retrato em cada uma.
Duração
3 a 10 segundos
Texto para vídeo gera clipes de 5 ou 10 segundos; imagem para vídeo Fast e video-extend geram de 3 a 10 segundos.
Áudio
Áudio sincronizado
Os endpoints de vídeo geram áudio sincronizado com a imagem, e um arquivo de áudio opcional (WAV ou MP3, de pelo menos 3 segundos, até 15 MB) pode guiar a geração.
Variantes Fast
Texto, imagem e extensão
O Wan 2.5 Fast está disponível para texto para vídeo, imagem para vídeo e video-extend, posicionado para uma geração mais rápida e acessível.
Ferramentas de imagem
Edição e texto para imagem
image-edit recebe até duas imagens de entrada com um prompt, e text-to-image gera imagens estáticas na mesma família dos endpoints de vídeo.
Endpoints
Todos os endpoints da API de Wan 2.5
8 endpoints de Wan 2.5 disponíveis agora na WaveSpeedAI — escolha a variante que combina com seu fluxo de trabalho.
/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.
Exemplos
Veja o Wan 2.5 em ação
Resultados reais gerados pela API do Wan 2.5. Passe o mouse sobre qualquer vídeo para pré-visualizar e clique para abrir o visualizador em tamanho real.
Como usar
Como usar a API do Wan 2.5
Quatro passos do cadastro até uma geração concluída. Exemplos completos em Python, Node.js e cURL estão na seção de API abaixo.
- 01
Obtenha uma chave de API
Crie uma conta na WaveSpeedAI e copie sua chave de API no painel. Contas novas recebem créditos iniciais grátis — o suficiente para usar o playground algumas dezenas de vezes antes de a cobrança começar.
- 02
Envie uma predição
Faça POST da sua entrada em JSON para https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video. O endpoint devolve um id de predição imediatamente — as gerações são assíncronas, então você não mantém uma conexão aberta durante a inferência.
- 03
Consulte até concluir
Faça GET em https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retorne os resultados quando o status for completed; pare com erro em failed, cancelled, timeout ou deleted; continue consultando em qualquer outro status.
- 04
Leia a URL do resultado
Quando o status for "completed", leia a URL em data.outputs[0]. A URL aponta para a mídia gerada na CDN da WaveSpeedAI — imagem, vídeo, áudio ou arquivo 3D, conforme a variante do Wan 2.5 que você chamou.
Casos de uso
O que você pode criar com o Wan 2.5
Fluxos de trabalho comuns para os quais desenvolvedores e criadores usam a API do Wan 2.5.
Texto para vídeo com áudio sincronizado
alibaba/wan-2.5/text-to-video transforma um prompt em um clipe de 5 ou 10 segundos em até 1080p, com áudio gerado junto com a imagem.
Imagem para vídeo a partir de uma imagem estática
alibaba/wan-2.5/image-to-video e a variante Fast animam uma imagem de referência com um prompt, em 720p ou 1080p e de 3 a 10 segundos no endpoint Fast.
Estenda um clipe
alibaba/wan-2.5/video-extend continua um vídeo existente com áudio sincronizado preservado ou gerado, em 480p, 720p ou 1080p, e a variante Fast faz o mesmo com menor custo.
Guie um clipe com seu próprio áudio
Envie um arquivo de áudio aos endpoints de vídeo para moldar a geração, por exemplo uma fala ou uma batida que o movimento deve acompanhar.
Edite imagens na mesma família
alibaba/wan-2.5/image-edit aplica edições guiadas por prompt a uma ou duas imagens, de modo que imagens estáticas e clipes saem de uma única família de modelos.
Imagens estáticas com text-to-image
alibaba/wan-2.5/text-to-image gera imagens a partir de um prompt, com o tamanho definido em pixels até 2880.
Dicas
Dicas de prompt para o Wan 2.5
Conselhos práticos para obter melhores resultados com o Wan 2.5 — extraídos dos padrões que funcionam em modelos de vídeo em pipelines de produção.
- 01
Prototipe no Fast, entregue no endpoint padrão
Use as variantes Fast para testar prompts e movimento e depois rode o endpoint padrão para o clipe final.
- 02
Escolha o tamanho para a plataforma
Texto para vídeo oferece tamanhos paisagem e retrato em 480p, 720p e 1080p, então escolha o tamanho conforme onde o clipe será exibido antes de gerar.
- 03
Use o áudio para orientar o tempo
Um WAV ou MP3 curto de pelo menos 3 segundos pode guiar a geração, o que ajuda quando o movimento deve acompanhar uma fala ou uma batida.
- 04
Estenda em pequenos passos
Com video-extend, continue um clipe alguns segundos por vez e descreva o que acontece em seguida, para que cada passo mantenha a cena e o áudio contínuos.
Preços
Preços da API de Wan 2.5
O preço é por resultado. O valor final varia conforme os parâmetros definidos no playground de cada variante (resolução, duração, quantidade de resultados, referências).
| Endpoint | Tipo | Preço inicial |
|---|---|---|
| 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
Chame a API de Wan 2.5
Crie uma chave de API em wavespeed.ai/accesskey e envie uma predição via REST. O playground gera exemplos prontos para colar para qualquer combinação de entradas.
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)Comparar
Wan 2.5 vs alternativas
Quando escolher o Wan 2.5 em vez de modelos semelhantes na WaveSpeedAI.
Wan 2.5 vs Wan 2.7
O Wan 2.7 é a geração mais nova, com reference-to-video, video-edit e saída em 1080p em mais endpoints. O Wan 2.5 continua sendo uma opção com variantes Fast e áudio sincronizado.
Wan 2.5 vs Veo 3.1
O catálogo apresenta o Wan 2.5 como mais rápido e acessível que o Google Veo 3, com geração guiada por áudio e video-extend. O Veo 3.1 oferece os níveis Standard, Fast e Lite em 1080p.
Wan 2.5 vs Kling 2.6
O Kling 2.6 acrescenta motion control e um endpoint create-voice. O Wan 2.5 cobre de 480p a 1080p com áudio sincronizado, video-extend, image-edit e text-to-image em uma só família.
FAQ
Wan 2.5 API — Perguntas frequentes
Preços, licença, integração — perguntas comuns sobre executar o Wan 2.5 na WaveSpeedAI.
Quais resoluções o Wan 2.5 suporta?
Os endpoints de vídeo geram saída em 480p, 720p e 1080p, conforme o endpoint. Texto para vídeo também oferece tamanhos em retrato, e imagem para vídeo Fast gera 720p ou 1080p.
O Wan 2.5 gera áudio?
Sim. Os endpoints de vídeo produzem áudio sincronizado com a imagem, e você pode enviar um arquivo de áudio opcional para guiar o resultado.
O que é o Wan 2.5 Fast?
São as variantes Fast de texto para vídeo, imagem para vídeo e video-extend, posicionadas para uma geração mais rápida e acessível do que as variantes padrão.
Posso estender um vídeo existente com o Wan 2.5?
Sim. O endpoint video-extend continua um clipe curto até um mais longo, com áudio sincronizado preservado ou gerado, e tem uma variante Fast.
O que é a API do Wan 2.5?
Wan 2.5 é um modelo de geração de vídeo da Alibaba disponibilizado como API REST na WaveSpeedAI. Alibaba Wan 2.5 — texto para vídeo e imagem para vídeo em até 1080p com áudio sincronizado, além de video-extend, image-edit e text-to-image na mesma família, com variantes Fast dos endpoints de vídeo. Você pode chamá-lo por código ou testá-lo no playground indicado acima.
Como chamo a API do Wan 2.5?
Crie uma conta na WaveSpeedAI, copie sua chave de API em /accesskey e faça POST para https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video com sua entrada em JSON. O endpoint devolve um id de predição. Consulte o endpoint de resultado a cada 2 segundos, aproximadamente, aumente o intervalo em tarefas longas e pare em qualquer status final. Exemplos prontos para produção em Python / Node.js / cURL estão acima.
Quanto custa a API do Wan 2.5?
O Wan 2.5 começa em $0.03 por execução. O custo exato varia conforme os parâmetros definidos (resolução, duração, quantidade de resultados, referências). A prévia de custo ao vivo ao lado do botão Gerar no playground mostra o preço exato da sua entrada atual.
Quais variantes do Wan 2.5 estão disponíveis?
A WaveSpeedAI hospeda 8 endpoints de Wan 2.5 ativos: 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. Cada variante tem sua própria página de playground e seu preço.
Posso usar os resultados do Wan 2.5 comercialmente?
Os direitos de uso comercial seguem a licença do modelo da Alibaba. A maioria dos modelos da Alibaba permite o uso comercial dos resultados; veja o resumo da licença na página do playground de cada modelo e os Termos de Serviço da WaveSpeedAI para as condições da plataforma.
Por que usar o Wan 2.5 na WaveSpeedAI em vez de ir direto à fonte?
Uma chave de API e uma conta de cobrança para o Wan 2.5 E mais de 1.000 outros modelos de IA de outros provedores. Sem configuração de SDK por fornecedor, sem limites de taxa separados, sem reescrever o código de integração a cada fornecedor. Os preços costumam ser iguais ou menores que os da API direta da Alibaba.
Provedor
Sobre a Alibaba
A equipe por trás do Wan 2.5 e de toda a linha de modelos da Alibaba na WaveSpeedAI.
O Tongyi Lab da Alibaba produz a família de modelos de vídeo Wan e a família de LLMs Qwen. O Wan se destaca por ter sido lançado com pesos abertos, ampla cobertura de variantes (texto para vídeo, imagem para vídeo, referência para vídeo, video-edit, video-extend, image-edit, texto para imagem) e força constante em estabilidade de movimento e aderência ao prompt com prompts em vários idiomas.
Comece a criar com o Wan 2.5 na WaveSpeedAI
Créditos iniciais grátis no cadastro. Uma chave de API para mais de 1.000 modelos de IA da Alibaba e de todos os outros provedores.