Geração de Vídeos Wan
Gere vídeos de IA através da API Wan (Alibaba) da AceDataCloud.
Configuração: Veja autenticação para configuração do token.
Início Rápido
curl -X POST https://api.acedata.cloud/wan/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "um golfinho pulando através das ondas do oceano na hora dourada", "model": "wan2.6-t2v"}'
Assíncrono: Veja polling de tarefas assíncronas. Faça polling via
POST /wan/taskscom{"id": "..."}.
Modelos
| Modelo | Tipo | Melhor Para |
|---|---|---|
wan2.6-t2v | Texto-para-Vídeo | Criar vídeo a partir de descrição textual |
wan2.6-i2v | Imagem-para-Vídeo | Animar uma imagem estática em vídeo |
wan2.6-r2v | Vídeo de Referência-para-Vídeo | Extração e transferência de personagem de vídeo de referência |
wan2.6-i2v-flash | Imagem-para-Vídeo (Rápido) | Geração rápida de imagem para vídeo |
Fluxos de Trabalho
1. Texto-para-Vídeo
POST /wan/videos
{
"action": "text2video",
"prompt": "um lapso de tempo de flores desabrochando em um prado",
"model": "wan2.6-t2v",
"resolution": "720P",
"duration": 5
}
2. Imagem-para-Vídeo
Anime uma imagem estática em um clipe de vídeo.
POST /wan/videos
{
"action": "image2video",
"prompt": "vento suave sopra pela cena",
"model": "wan2.6-i2v",
"image_url": "https://example.com/landscape.jpg",
"resolution": "720P",
"duration": 5
}
3. Imagem-para-Vídeo (Flash)
Geração de imagem para vídeo mais rápida com latência reduzida.
POST /wan/videos
{
"action": "image2video",
"prompt": "câmera se move lentamente pela paisagem",
"model": "wan2.6-i2v-flash",
"image_url": "https://example.com/scene.jpg"
}
4. Transferência de Vídeo de Referência
Extraia personagens ou timbres de um vídeo de referência e transfira-os para uma nova geração.
POST /wan/videos
{
"action": "text2video",
"prompt": "o personagem caminha por uma cidade futurista à noite",
"model": "wan2.6-r2v",
"reference_video_urls": ["https://example.com/reference.mp4"]
}
5. Edição de Múltiplos Cortes
Gere um vídeo com várias tomadas em vez de uma única tomada contínua.
POST /wan/videos
{
"action": "text2video",
"prompt": "um chef preparando uma refeição em uma cozinha movimentada",
"model": "wan2.6-t2v",
"shot_type": "multi",
"duration": 10
}
6. Vídeo com Áudio
Habilite a geração de áudio junto com o vídeo.
POST /wan/videos
{
"action": "text2video",
"prompt": "ondas do oceano quebrando em uma costa rochosa",
"model": "wan2.6-t2v",
"audio": true
}
Parâmetros
| Parâmetro | Obrigatório | Valores | Descrição |
|---|---|---|---|
action | Sim | "text2video", "image2video" | Tipo de ação |
prompt | Sim | string | Descrição da cena |
model | Sim | "wan2.6-t2v", "wan2.6-i2v", "wan2.6-r2v", "wan2.6-i2v-flash" | Modelo |
image_url | Para image2video | string | URL da imagem de origem (obrigatório para imagem-para-vídeo) |
negative_prompt | Não | string (máx. 500 caracteres) | Conteúdo a ser excluído da geração |
reference_video_urls | Para r2v | array de strings | Vídeos de referência para extração de personagem/timbre |
shot_type | Não | "single", "multi" | Tomada contínua ou edição de múltiplos cortes |
audio | Não | boolean | Habilita áudio no vídeo gerado |
audio_url | Não | string | URL do áudio de referência |
resolution | Não | "480P", "720P", "1080P" | Resolução de saída (padrão: 720P) |
size | Não | string | O tamanho do vídeo gerado |
duration | Não | 5, 10, 15 | Duração do vídeo em segundos |
prompt_extend | Não | boolean | Habilita reescrita de prompt baseada em LLM |
callback_url | Não | string | URL de notificação de webhook assíncrona |
Armadilhas
image_urlé obrigatório para os modeloswan2.6-i2vewan2.6-i2v-flashreference_video_urlsé usado apenas comwan2.6-r2vpara transferência de personagem/timbrenegative_prompttem um comprimento máximo de 500 caracteres- As durações suportadas são apenas 5, 10 ou 15 segundos
- A resolução padrão é 720P; use 1080P para maior qualidade com custo aumentado
shot_type: "multi"produz edições de múltiplos cortes em vez de uma única tomada contínua
MCP:
pip install mcp-wan| Hospedado:https://wan.mcp.acedata.cloud/mcp| Veja todos os servidores MCP