O modelo de imagem para vídeo Wan gera vídeos fluidos a partir de uma imagem do primeiro quadro, uma imagem do último quadro e um prompt de texto opcional.
- Especificações de vídeo: Duração fixa de 5 segundos e resolução personalizada (480P/720P/1080P).
- Capacidades adicionais: Reescrita de prompt e marca d'água.
Primeiros passos
| Prompt | Primeiro quadro | Último quadro | Vídeo de saída |
| Um monstro azul fofo com expressão levemente triste está na chuva. A câmera aproxima lentamente e para no momento em que ele olha para o céu. | ![]() | ![]() |
- Python SDK
- Java SDK
- curl
A video_url expira após 24 horas. Baixe o vídeo imediatamente.
Disponibilidade
- Os modelos suportados variam conforme a região. Os recursos são isolados entre regiões. Para verificar os modelos suportados em cada região, consulte o console do Model Studio.
- Ao fazer uma chamada, certifique-se de que seu modelo, URL do endpoint e chave de API pertençam à mesma região. Chamadas entre regiões falham.
Capacidades principais
Gerar vídeo a partir do primeiro e último quadros
Modelos suportados: Todos os modelos.
Gera vídeos fluidos a partir das imagens do primeiro e do último quadros.
Parâmetros:
first_frame_url: Obrigatório. Forneça a imagem do primeiro quadro.last_frame_url: Obrigatório. Forneça a imagem do último quadro.prompt: Opcional (recomendado). Controla como o vídeo muda ao longo do tempo.
| Prompt | Primeiro quadro | Último quadro | Vídeo de saída |
| Estilo realista. Um gatinho preto curioso olha para o céu. A câmera começa na altura dos olhos e sobe gradualmente até capturar o olhar curioso do gatinho de cima. | ![]() | ![]() |
- Python SDK
- Java SDK
- curl
É necessário ter o DashScope Python SDK ≥ 2.0.1 . Atualize se necessário .
Imagem de entrada
- Quantidade de imagens: Uma imagem para o primeiro quadro e uma para o último quadro.
- Métodos de entrada: URL da imagem, caminho do arquivo local .
Método 1: URL da imagem (API HTTP e SDK) Recomendado
Método 1: URL da imagem (API HTTP e SDK) Recomendado
- URL pública: HTTP ou HTTPS (por exemplo, https://xxxx/xxx.png).
Método 2: Caminho do arquivo local (apenas SDK)
Método 2: Caminho do arquivo local (apenas SDK)
Sistema operacional | Caminho do arquivo de entrada | Exemplo (caminho absoluto) | Exemplo (caminho relativo) |
|---|---|---|---|
Linux / macOS | file://{caminho absoluto ou relativo} | file:///home/images/test.png | file://./images/test.png |
Windows | file://D:/images/test.png | file://./images/test.png |
Sistema operacional | Caminho do arquivo de entrada | Exemplo (caminho absoluto) |
|---|---|---|
Linux / macOS | file://{caminho absoluto} | file:///home/images/test.png |
Windows | file:///{caminho absoluto} | file:///D:/images/test.png |
Código de exemplo: Múltiplos métodos de entrada de imagem
Vídeo de saída
- Quantidade de vídeos: Um.
- Especificações: Variam conforme o modelo. Consulte Especificações de vídeo.
- Expiração da URL: 24 horas.
-
Dimensões: Determinadas pela imagem do primeiro quadro e pela configuração de
resolution.- O modelo preserva a proporção do primeiro quadro e ajusta a contagem total de pixels para o alvo. As dimensões de saída são ajustadas automaticamente para serem divisíveis por 16 (requisito de codificação).
- Exemplo: Uma entrada de 750×1000 (3:4) com resolution="720P" (alvo ≈920K pixels) pode resultar em uma saída de 816×1104 (proporção ≈0.739, ≈900K pixels, ambos divisíveis por 16).
Faturamento e limitação de taxa
- Para detalhes sobre cota gratuita e preços, consulte Wanx-Image-to-Video-First-Last-Frame.
- Para limitação de taxa do modelo, consulte Série Wanxiang.
-
Detalhes de faturamento:
- A entrada é gratuita. O faturamento da saída baseia-se nos segundos de vídeo gerados com sucesso.
- Chamadas com falha não geram cobranças e não consomem a cota gratuita.
- O recurso de imagem para vídeo também suporta planos de economia.
Referência da API
Imagem para vídeo - primeiro e último quadros - Referência da API
FAQ
P: Como gero um vídeo com uma proporção específica (como 3:4)?
R: A API não suporta controle direto da proporção — apenas de resolution.
O parâmetro resolution controla a contagem de pixels, não a proporção. O modelo preserva a proporção do primeiro quadro (first_frame_url) com pequenos ajustes para codificação (as dimensões devem ser múltiplos de 16). Para um vídeo 3:4, envie uma imagem de primeiro quadro na proporção 3:4.
Exemplo: Uma entrada de 750×1000 (3:4) com resolution="720P" (alvo ≈920K pixels) pode resultar em uma saída de 816×1104 (proporção ≈0.739, ≈900K pixels, ambos divisíveis por 16).
P: Por que recebo um erro “url error, please check url!” ao executar o código do SDK?
R: Certifique-se de que sua versão do SDK atenda ao requisito mínimo: DashScope Python SDK ≥ 2.0.1 ou DashScope Java SDK ≥ 2.22.6. Versões mais antigas podem apresentar erros do tipo "url error, please check url!". Atualize o SDK.


