Introdução
Wan 3.0 Spicy Imagem para vídeo é o endpoint de imagem para vídeo da família Wan 3.0 Spicy, ajustado para renderizar o que a versão padrão suaviza. Um quadro inicial em image_url e um prompt opcional viram de 2 a 30 segundos de vídeo em 480p, 720p ou 1080p, com áudio gerado. A imagem parada fornece a pessoa, o figurino, o cenário e a luz; o prompt fornece o movimento, a câmera e o som. Adicione last_image_url para fixar o final.
A requisição não traz flag de conteúdo nem declaração por requisição. No nosso teste de seis níveis de 2026-09-30, todos os níveis saíram como pedido.
Recursos e destaques
Seis níveis testados, seis renderizados
Rodamos nosso teste de conteúdo padrão em 480p e cinco segundos: seis prompts distribuídos em cinco níveis de intensidade, de Leve a Máximo (os prompts de teste não são publicados). Nada foi recusado, coberto ou trocado por outra pessoa, e nenhum dos prompts precisou ser suavizado.
Vai além do prompt por conta própria
Esta é a parte para a qual é preciso planejar. Em nossas gravações de exemplo enviamos seis quadros iniciais com prompts dizendo que o figurino permanece como está; quatro voltaram com o figurino alterado, incluindo todos os quadros com mais de uma pessoa. Trate o prompt como um pedido, não como uma garantia, e revise o clipe inteiro.
Até 30 segundos em uma requisição
duration_seconds aceita qualquer número inteiro de 2 a 30, padrão 5. Uma requisição de cinco segundos devolve cerca de 5,04 segundos a 30 quadros por segundo. resolution é 480p, 720p (padrão) ou 1080p, e tanto a duração quanto a resolução afetam preço e prazo.
Formato, som e último quadro
aspect_ratio aceita 16:9, 9:16, 1:1, 4:3 ou 3:4; se omitir, o clipe segue o still. generate_audio vem ligado por padrão. last_image_url fixa o quadro final: no nosso teste o clipe terminou na imagem enviada, cortada para a proporção pedida.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Não | Opcional, mas vale escrever: uma ação, um movimento de câmera, uma observação sobre o som. Pedir que o figurino permaneça sem mudanças não o mantém de forma confiável neste modelo. pelo menos 1 caracteres |
image_url | Sim | Obrigatório. O quadro de abertura: a pessoa, o figurino, o ambiente e a luz vêm todos dele. |
last_image_url | Não | Último quadro opcional. O clipe termina nesta imagem, cortada para a proporção pedida. |
aspect_ratio | Não | 16:9, 9:16, 1:1, 4:3 ou 3:4. Se omitir, o clipe segue o formato do quadro de abertura; uma proporção diferente corta o quadro. |
resolution | Não | 480p, 720p ou 1080p, padrão 720p. Quanto maior a resolução, maior o custo por segundo e mais tempo de espera. |
duration_seconds | Não | Qualquer número inteiro de 2 a 30, padrão 5. Cobrado por segundo solicitado. |
generate_audio | Não | Ligado por padrão, sem custo extra: o clipe volta com som alinhado à imagem. Defina como false para um clipe mudo. Valor padrão: |
enable_prompt_expansion | Não | Desligado por padrão, sem custo extra. Quando ligado, um prompt curto é reescrito em um mais longo antes da geração; deixe desligado quando o seu texto já for preciso. Valor padrão: |
seed | Não | De 0 a 2147483647. Mantenha-a fixa ao comparar resoluções ou durações: deixa as execuções comparáveis, não idênticas quadro a quadro. |
Preços
| Especificação | Preço |
|---|---|
| $0.057 / segundo |
| $0.114 / segundo |
| $0.228 / segundo |
Casos de uso
Cenas que outras APIs recusam
Cenas que outras APIs recusam ou suavizam: envie a imagem parada, descreva o movimento e receba o clipe. Só podem ser usados adultos que consentiram e material devidamente licenciado, e você é responsável por direitos, idade e legislação local de todas as pessoas retratadas.
Personagens de companhia e roleplay
Guarde o still de um personagem e reutilize-o como quadro de abertura de todos os clipes, mudando só a ação. O still carrega o rosto e o figurino, então o personagem continua sendo a mesma pessoa de clipe para clipe.
Takes longos com final planejado
Peça até 30 segundos e adicione last_image_url para que o take termine na pose de onde o seu próximo plano começa.
Guia de prompt e dicas práticas
Deixe o quadro cuidar do visual
Coloque figurino, cenário e luz no still, e reserve o prompt para o que se move. O exemplo da janela desta página rodou com duration_seconds 5 e resolution 720p:
She turns from the rainy window toward the camera; the loose strap slides a little further down her shoulder and she lets it rest there, a slow half smile. Pink and cyan neon ripples over the wet glass and her collarbone. She stays in the velvet dress the whole time. Slow push-in. Rain on the glass, distant traffic hum.
A requisição exata por trás do clipe deste endpoint, gerada a partir do quadro de abertura mostrado ao lado.
Rascunho em 480p, depois render
Um clipe de cinco segundos em 480p levou cerca de um minuto e meio nos nossos testes. Feche a ideia ali, mantenha a seed e renderize de novo em 720p ou 1080p. Mude um campo por execução para que cada comparação ensine alguma coisa.
Quando a roupa precisa ficar
Nenhuma redação de prompt impede de forma confiável que este modelo troque o figurino de um sujeito. Para um clipe em que o guarda-roupa precisa se manter, use o Wan 3.0 de imagem para vídeo padrão e reserve o Spicy para cenas em que essa inclinação é justamente o objetivo.
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-spicy/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.
