API de referência para vídeo do Wan 3 Spicy: requisição, preço e consulta

Envie imagens, vídeos ou áudios autorizados à API do Wan 3 Spicy, estime uma execução de cinco segundos e obtenha o resultado assíncrono.

Conclusão principalUse mode=reference-to-video com pelo menos uma lista de referências. Comece com uma imagem e cinco segundos fixos; confira a cotação da sua conta antes de enviar.

Quando usar referências para vídeo

Use referências quando uma nova cena precisar aproveitar a aparência de um produto, um padrão de movimento ou um som sem fixar o primeiro quadro. O Wan 3 Spicy aceita até 10 reference_images, 5 reference_videos e 5 reference_audios no mesmo endpoint POST /v1/videos/generations. O modo reference-to-video exige pelo menos uma dessas listas. Não combine referências com first_frame ou last_frame, que pertencem ao modo imagem para vídeo.

Comece com uma imagem que você possui ou está autorizado a usar. Em uma cena simples de produto, uma imagem aprovada é mais fácil de avaliar do que muitas referências conflitantes. Dê a cada referência adicional uma função clara no prompt.

Enviar uma requisição de cinco segundos

Confirme o acesso para adultos ao modelo Spicy na sua conta e configure MODELRUSH_API_KEY no servidor. A chave API precisa permitir vídeo e acesso ao Wan 3 Spicy. Substitua a URL de exemplo por uma imagem HTTPS acessível que você tem autorização para processar. Crie uma chave de idempotência uma vez e reutilize-a se precisar repetir o mesmo envio por falha de rede.

bash
REQUEST_KEY="$(uuidgen)"
curl -sS https://api.modelrush.ai/v1/videos/generations \
  -H "Authorization: Bearer $MODELRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $REQUEST_KEY" \
  -d '{
    "model": "modelrush/wan3-spicy",
    "mode": "reference-to-video",
    "prompt": "A garrafa de cerâmica azul da imagem de referência está sobre uma base de pedra. Uma cena contínua com a câmera girando lentamente no sentido horário e luz lateral quente.",
    "reference_images": ["https://example.com/approved-bottle.jpg"],
    "duration": 5,
    "resolution": "480P",
    "ratio": "16:9",
    "audio": true
  }'

A API retorna HTTP 202 com ID da geração, estado queued e poll_url. Salve a resposta. Se o cliente expirar após o envio, consulte o trabalho salvo ou tente novamente com a mesma chave de idempotência, em vez de criar outro trabalho.

Consultar o resultado

Copie o caminho relativo poll_url da resposta 202 para POLL_URL e consulte o domínio da API com a mesma chave. Repita com intervalo limitado até o endpoint de vídeo indicar completed ou failed. A resposta concluída inclui video_url; baixe o resultado que deseja guardar, pois a URL pode expirar após 24 horas.

bash
curl -sS "https://api.modelrush.ai$POLL_URL" \
  -H "Authorization: Bearer $MODELRUSH_API_KEY"

Verificar duração e preço

O Wan 3 Spicy aceita duração fixa de saída de 2 a 30 segundos inteiros; sem informar o valor, usa 5 segundos, e -1 não está disponível. Os vídeos de referência podem somar até 15 segundos; sua duração junto à saída solicitada não pode passar de 30 segundos. O áudio de referência pode somar até 15 segundos. O gateway valida a mídia antes de enviar a geração.

Em 28 de setembro de 2026, a tarifa pública do Registry para Wan 3 Spicy em 480P era de $0.045 por segundo de saída. A requisição acima, com cinco segundos e uma imagem de referência, tem estimativa de $0.225 pela tarifa pública (5 × $0.045). Este exemplo não inclui vídeo de referência. A tarifa da sua conta pode ser diferente; confira a cotação da conta antes de gerar. Verifique o preço atual na página do modelo Wan 3 Spicy ou na página de preços antes de aumentar a resolução ou o volume.

Veja o esquema completo na documentação de vídeo. Confira o modelo Wan 3 Spicy e teste referência para vídeo no Playground.