Introdução
Wan 3.0 Pro Imagem para vídeo anima um quadro inicial e entrega o clipe em 1080p, 2K ou 4K, com 2 a 30 segundos. image_url é o único campo obrigatório e é usado exatamente como primeiro quadro, então figurino, corpo, cenário e luz vêm da sua imagem; o prompt é opcional e deve tratar só de movimento e câmera. last_image_url fixa opcionalmente o último quadro exato e só funciona junto com image_url. O áudio é gerado com a imagem, a menos que você o desligue.
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 Pro Texto para vídeo |
| Uma imagem inicial aprovada fixa sujeito e composição; a instrução direciona o movimento seguinte. | Wan 3.0 Pro 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 Pro Referências para vídeo |
Recursos e destaques
Um render 4K não deixa nítida uma imagem suave
O quadro inicial é o teto de qualidade da cena, e os níveis 2k e 4k ampliam um render nativo em 1080p em vez de desenhar detalhe novo. Uma fonte suave ou de baixa resolução continua suave em 4K. Envie a imagem mais nítida que você tiver, em JPEG, PNG sem transparência, BMP ou WEBP, de 240 a 8000 pixels por lado, até 20 MB e não mais larga que 8:1.
As duas pontas fixadas para masters prontos para edição
O exemplo da garrafa envia o mesmo packshot como image_url e last_image_url em 4k, com expansão de prompt e áudio desligados e uma semente fixa, 5512090. A garrafa gira um quarto de volta, o brilho percorre todo o comprimento do vidro e ela volta ao ângulo inicial — um master cujo rótulo continua legível quando o editor faz um zoom digital.
O enquadramento segue a imagem por padrão
aspect_ratio é adaptive por padrão e segue o quadro inicial. Fixe 16:9, 4:3, 1:1, 3:4 ou 9:16 só quando o formato de entrega estiver definido. Nenhum dos quatro exemplos publicados define proporção, então cada clipe mantém o formato da imagem de origem.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional aqui, porque o quadro já carrega a aparência. Use só para movimento e câmera. pelo menos 1 caracteres · no máximo 20000 caracteres |
image_url | Sim | O quadro de abertura, usado exatamente como primeiro quadro, e o verdadeiro teto de qualidade do plano. pelo menos 1 caracteres |
last_image_url | Não | Opcional, e só junto com |
resolution | Não | 1080p, 2k ou 4k, padrão 1080p. |
aspect_ratio | Não | adaptive segue o quadro de abertura. Fixe 16:9, 4:3, 1:1, 3:4 ou 9:16 apenas quando o formato de entrega for fixo. |
duration_seconds | Não | Qualquer número inteiro de 2 a 30, padrão 5, 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… |
generate_audio | Não | Ligado por padrão. O som é gerado junto com a imagem e chega dentro do mesmo arquivo. Valor padrão: |
enable_prompt_expansion | Não | Ligada por padrão nesta família. Ela completa briefings magros e reescreve os detalhados, então desligue assim que o prompt for uma descrição precisa de plano. Valor padrão: |
seed | Não | De 0 a 2147483647. Fixe enquanto ajusta resolução ou duração; do contrário cada reexecução muda duas coisas ao mesmo tempo. |
Preços
| Especificação | Preço |
|---|---|
| $0.144 / segundo |
| $0.16 / segundo |
| $0.184 / segundo |
Casos de uso
Percursos longos com um final aprovado
O exemplo do cume envia o pé da montanha como image_url e o topo como last_image_url e renderiza 10 segundos em 4K, com o prompt cobrindo só a subida entre os dois. Uma subida longa é justamente onde um final solto se desvia; fixar o quadro de chegada permite aprovar o desfecho como imagem estática antes de pagar por um render 4K.
O figurino fica no quadro
O exemplo do ombro de seda parte de uma imagem que já contém o figurino, então o prompt dedica tudo ao movimento: os ombros giram devagar em direção à câmera, a seda capta a luz, a respiração se acalma, um push-in lento com uma luz principal dura pela esquerda e chuva na janela atrás. O render tem 5 segundos em 2k.
Guia de prompt e dicas práticas
Use o prompt só para movimento e câmera
Nesta família a expansão de prompt vem ligada e reescreve um briefing de movimento detalhado, então mude enable_prompt_expansion para false quando a redação estiver fechada, como faz o exemplo da garrafa. Depois diga quem se move, quanto e com que velocidade, e o que a câmera faz. O prompt aceita até 20.000 caracteres, mas uma ação clara mexe mais no resultado do que uma lista longa.
Aprove em 1080p e depois renderize grande
Defina enquadramento e movimento em 5 segundos e 1080p com seed fixo; uma repetição que muda resolução e semente ao mesmo tempo muda duas coisas de uma vez. Quando os dois quadros estiverem aprovados e o movimento estiver claro, reenvie o mesmo corpo em 2k ou 4k. A duração vai de 2 a 30 segundos inteiros, ou -1 para o modelo escolher.
Confira o detalhe ampliado no arquivo entregue
Em um arquivo 2K ou 4K, confira primeiro as áreas que a ampliação estica: texto do rótulo, reflexos especulares duros, textura de cabelo e pele. O exemplo do espelho embaçado é um caso exigente: vapor subindo e embaçando um espelho, a figura virada para longe da lente, um push-in lento além de uma arandela, renderizado em 4k entre um primeiro e um último quadro fixados.
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-pro/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "1080p"
}
}'
# 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.
