Wan 3.0 Pro Prime API

Wan 3.0 Pro Prime Imagem para vídeo anima um quadro inicial no render Prime e o entrega em 1080p, 2K ou 4K, com 2 a 30 segundos. image_url é obrigatório e vira exatamente o primeiro quadro; o prompt é opcional e deve descrever movimento e câmera; last_image_url fixa opcionalmente o quadro final. Os campos são exatamente os do Wan 3.0 Pro Imagem para vídeo, então uma requisição montada para aquele endpoint roda aqui trocando só o nome do modelo.

Escolha o modo pelo material inicial

Instruções de dois quadros, como uma troca de foco

Uma troca de foco é, por natureza, coisa de dois quadros, e é para isso que serve last_image_url. O exemplo do botão de flor começa nítido em um botão e termina em um quadro enviado que está nítido em uma camisa desabotoada atrás dele, 6 segundos em 4k; o prompt só diz quando a passagem acontece. Uma profundidade de campo muito rasa deixa ao render pouca margem para cair no plano certo sem um final fixado.

Quem define o teto é a imagem, não o nível

A resolução comanda o render, não a entrada. Os níveis 2k e 4k são ampliados a partir de um render nativo em 1080p, então envie a imagem mais nítida que você tiver: 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.

Planos parados para edições com trilha à parte

O exemplo da luz no beco é um plano parado de 4 segundos em 2k com áudio e expansão de prompt desligados: "Nobody moves. Only the neon tube above her stutters and the rain keeps falling, dragging its reflection across the wet plastic. Locked camera." É o formato de requisição para uma cena que vai ganhar trilha na edição em vez de trazer som próprio.

Mudança de ambiente em volta de um sujeito parado

O exemplo do beco de neon parte de uma placa que já traz o beco, a chuva e a capa transparente, então o prompt diz só o que muda: a chuva apertando, um tubo de neon piscando uma vez, vapor subindo de uma grade e a pessoa sustentando o olhar para a lente o tempo todo. A linha de áudio nomeia cada fonte — chuva no aço, um tubo zumbindo, uma grade chiando.

Detalhe de perto com o final fixado

O exemplo da camisa reaproveita os mesmos dois quadros do exemplo do botão, em 1080p por 4 segundos: uma mão afasta devagar uma camisa aberta sob uma luz dourada rasante e a deixa cair de volta, enquanto o botão entre as dobras se abre um pouco. Fixar as duas pontas faz uma profundidade de campo muito rasa cair no plano pretendido.

# 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-prime/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.