Introdução
Wan 3.0 Prime Imagem para vídeo anima um quadro inicial por 2 a 30 segundos no render Prime, com os mesmos campos do Wan 3.0 Imagem para vídeo. image_url é obrigatório e vira exatamente o primeiro quadro; o prompt é opcional e só precisa descrever o movimento; last_image_url fixa opcionalmente o quadro final. A resolução é 480p, 720p ou 1080p, com 720p como padrão, e o áudio é gerado com a imagem, a menos que você coloque generate_audio em false.
Escolha o modo pelo material inicial
| Material inicial | Modo |
|---|---|
| Um briefing escrito define cena, ação, câmera e, quando necessário, som. | Wan 3.0 Prime Texto para vídeo |
| Uma imagem inicial aprovada fixa sujeito e composição; a instrução direciona o movimento seguinte. | Wan 3.0 Prime Imagem para vídeo |
| Referências separadas podem orientar identidade, local, movimento ou som, com uma função clara para cada uma. | Wan 3.0 Prime Referências para vídeo |
Recursos e destaques
Cenário e figurino na imagem, ação no prompt
Como o quadro já traz o visual, a requisição inteira pode se concentrar em ação e som. O exemplo da sauna começa com uma imagem fixa que já tem o cenário e o figurino; o prompt cobre uma concha de água batendo em pedras quentes, uma rajada de vapor, as costas de um pulso passando sobre a clavícula e uma linha de áudio com o chiado, a madeira de cedro rangendo e uma respiração lenta.
Um final fixo deixa mudanças longas seguras
last_image_url faz o clipe terminar exatamente em uma imagem enviada. O exemplo da pista de dança começa em uma pista vazia e termina em um quadro enviado de um salão lotado, 10 segundos em 1080p e 3:4 sem áudio, então o modelo inventa como o salão enche, e não com o que ele termina cheio.
O formato do quadro por padrão
Se você omitir aspect_ratio, o clipe mantém o formato do quadro inicial; um valor conflitante recorta. São aceitos JPEG, PNG sem transparência, BMP ou WEBP, de 240 a 8000 pixels por lado, até 20 MB e não mais largos que 8:1. O quadro final segue os mesmos limites.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional: sem ele, o modelo anima o quadro de abertura por conta própria. Se escrever um, descreva o plano: sujeito, uma ação, um movimento de câmera, e então luz e som. pelo menos 1 caracteres |
image_url | Sim | O quadro de abertura, usado exatamente como primeiro quadro, e o verdadeiro teto de qualidade do plano. |
last_image_url | Não | Opcional, e só junto com |
aspect_ratio | Não | 16:9, 9:16, 1:1, 4:3, 3:4 ou adaptive, que deixa o modelo escolher. Omita para herdar o formato do quadro de abertura; um valor conflitante corta. |
enable_thinking | Não | Faz o modelo analisar o pedido e o material de referência antes de gerar. Valor padrão: |
resolution | Não | 480p, 720p ou 1080p. Padrão 720p. |
duration_seconds | Não | Qualquer número inteiro de 2 a 30, ou -1 para duração inteligente, em que o modelo escolhe a duração: o máximo de 30 segundos é reservado de antemão e a cobrança fica na duração… |
generate_audio | Não | Ligado por padrão. O clipe volta com som já travado à imagem. Valor padrão: |
enable_prompt_expansion | Não | Desligada por padrão. Ligada, o prompt é reescrito antes da geração, o que ajuda briefings magros e briga com você nos detalhados. Valor padrão: |
seed | Não | De 0 a 2147483647. Mantenha fixo para comparar um campo alterado por vez; tire para ter variedade. |
Preços
| Especificação | Preço |
|---|---|
| $0.0612 / segundo |
| $0.126 / segundo |
| $0.252 / segundo |
Casos de uso
Ação rápida a partir de uma imagem
O exemplo da praia parte de uma amazona a cavalo e pede que o meio-galope vire galope, que areia e água rasa espirrem atrás dos cascos e que um travelling rápido a acompanhe enquanto ela passa rumo a um sol baixo. Nessa velocidade o quadro inicial deixa de ajudar, então o prompt carrega a física: o que é lançado, em que direção e como a câmera acompanha.
Um gesto com o fim fixado
O exemplo do baile de máscaras fixa as duas pontas — um primeiro e um último quadro enviados da mesma mulher na mesma escadaria de mármore — e descreve a entrada entre eles: ela tira a máscara dourada, junta o vestido e desce alguns degraus em direção à câmera enquanto os convidados mascarados erguem as taças. Como a imagem final foi feita a partir da inicial, o vestido, o lustre e os convidados continuam no lugar. Tem 5 segundos em 720p, com som.
Guia de prompt e dicas práticas
Aprove primeiro o quadro de chegada como imagem
Quando o final importa, crie o último quadro antes de renderizar, no mesmo cenário e com o mesmo enquadramento do primeiro. Aprovar como imagem estática é muito mais barato do que iterar sobre um meio longo, e a tarefa do prompt passa a ser descrever uma transição em vez de inventar um destino.
Escreva o som como uma lista de fontes
O prompt da sauna termina com uma linha "Audio:" que nomeia cada fonte. Isso é mais confiável do que uma palavra de clima e prende cada som à ação que o causa. Coloque generate_audio em false, como no exemplo da pista de dança, quando o clipe for ganhar trilha na edição.
Acerte curto e depois estenda
Rode o movimento em 5 segundos com seed fixo e depois estenda. Clipes longos desviam mais em identidade e geometria, e cruzamentos rápidos de braços e pernas em 30 segundos são onde os artefatos aparecem primeiro. Deixe enable_prompt_expansion no padrão false para que um briefing de movimento preciso não seja reescrito antes da geração.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/wan-3.0-prime/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
