Introdução
Wan 2.2 texto para vídeo gera um clipe apenas a partir de um prompt escrito. Cada solicitação devolve um único vídeo sem som de cinco segundos, em 16:9 ou 9:16, renderizado em 480p ou 720p. O prompt aceita até 5.000 caracteres e é o único campo obrigatório: a proporção padrão é 16:9, a resolução padrão é 480p, e a expansão do prompt fica desligada a menos que você a ative.
Escolha um modo do Wan 2.2 pelo material de partida
| O que você tem no início | Modo | O que a solicitação precisa |
|---|---|---|
| uma cena escrita ou um roteiro | Wan 2.2 texto para vídeo | um prompt; 16:9 ou 9:16 |
| uma imagem estática que você quer manter | Wan 2.2 imagem para vídeo | uma imagem e um prompt; a imagem define o formato |
Recursos e destaques
Uma tomada fixa de cinco segundos
O texto para vídeo não tem ajuste de duração: toda tomada tem exatamente cinco segundos, então você sabe a duração da solicitação antes de enviá-la. Cinco segundos comportam um único momento (um sujeito, uma ação e um movimento de câmera), e não uma sequência de acontecimentos. Prompts escritos nessa escala são os que rendem os resultados mais confiáveis.
Dois formatos e duas resoluções
A proporção padrão é 16:9, ou 9:16 para publicação vertical. Quadros quadrados e 4:3 não estão disponíveis; para uma entrega quadrada, gere em 16:9 e recorte na edição. A resolução é 480p ou 720p, e é o único ajuste que altera o preço, o que faz de 480p o nível natural para rascunhos.
Só imagem
Os clipes chegam sem faixa de áudio e não há nenhum ajuste de som. Tudo o que o espectador deve sentir precisa estar visível: o exemplo publicado da plataforma com neve constrói o ritmo com neve caindo, a respiração condensando no frio e uma lâmpada da plataforma piscando, em vez de depender de som ambiente.
Expansão do prompt e seed opcionais
A expansão do prompt reescreve uma instrução curta em uma versão mais completa antes da geração. O seed aceita valores de 0 a 2147483647 e mantém a fonte aleatória fixa para você comparar uma mudança por vez; ele não garante um clipe idêntico quadro a quadro numa segunda execução.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | A cena em si, até 5.000 caracteres: quem, uma ação, um movimento de câmera e depois a luz. Um verbo claro mexe mais no resultado do que uma pilha de adjetivos. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | 16:9 ou 9:16, padrão 16:9. Este endpoint não oferece quadrado nem 4:3. |
resolution | Não | 480p ou 720p, padrão 480p. É o único ajuste que muda o preço. |
enable_prompt_expansion | Não | Desligado por padrão. Ligado, um brief curto é reescrito em uma versão mais completa antes da geração; deixe desligado quando seu prompt já descrever a cena com precisão. Valor padrão: |
seed | Não | De 0 até 2147483647. Mantenha fixo para comparar uma mudança por vez; omita para ter variedade. |
Preços
Cada requisição devolve um clipe de cinco segundos.
| Especificação | Preço |
|---|---|
| $0.24 / requisição |
| $0.48 / requisição |
Casos de uso
Rascunhos de storyboard em lote
Escreva cada momento do storyboard como um prompt separado e renderize a lista inteira em 480p. Cinco segundos bastam para avaliar enquadramento e movimento, e como todas as solicitações têm a mesma duração e o preço depende só da resolução, você conhece o custo do lote antes de enviá-lo. Renderize de novo em 720p as tomadas que você mantiver, com o mesmo prompt e o mesmo seed.
Clipes verticais para redes sociais
Defina a proporção como 9:16 e descreva uma única ação contínua. O exemplo publicado da feira noturna faz exatamente isso em 720p: uma jovem de capa de chuva amarela pega um espetinho numa barraca de churrasco, a fumaça e o vapor sobem entre varais de lâmpadas, e ela se vira e caminha em direção à câmera, que se aproxima devagar na mão.
Verificar se uma ideia de plano funciona em movimento
Antes de partir para uma tomada em 720p, você pode testar a ideia gastando pouco. O exemplo da escada do farol foi escrito como uma ação e uma posição de câmera (um homem mais velho com uma lanterna sobe a última volta de uma escada em caracol enquanto uma câmera baixa o acompanha) e renderizado em 16:9 a 480p.
Guia de prompt e dicas práticas
Escreva um único momento em ordem fixa
Nomeie o sujeito, a ação única, um movimento de câmera e, por último, a luz. Um verbo claro move o resultado mais do que uma pilha de adjetivos: um homem que sobe a última volta de uma escada e para diante de uma janela dá ao clipe um começo e um fim dentro de cinco segundos.
Use os caracteres para detalhes, não para mais cenas
O limite de 5.000 caracteres deixa espaço para figurino, cenário, clima e luz, mas cinco segundos não sustentam um segundo acontecimento. Se uma instrução tiver vários, divida-os em solicitações separadas e junte os clipes na edição.
Mantenha o seed durante as revisões
Escolha um seed e mantenha-o enquanto muda uma única coisa, como um verbo, o movimento de câmera ou a proporção. O exemplo da feira noturna fixa o seed 250728 para que o mesmo enquadramento possa ser comparado entre versões do prompt. Omita o seed quando quiser variedade.
Decida cedo sobre a expansão do prompt
Se você só tem uma ideia de uma linha, ativar a expansão do prompt faz o serviço escrever uma instrução mais completa por você. Quando o seu prompt já nomeia sujeito, ação, câmera e luz, deixe-a desligada para que o texto seja executado como foi escrito, e avalie qualquer versão expandida comparando-a com uma sem expansão.
Saiba quando o texto não basta
Um prompt sozinho não mantém um rosto ou um produto específico estável de uma execução para outra. Quando o sujeito precisar corresponder a uma imagem estática aprovada, passe para o Wan 2.2 imagem para vídeo e deixe a imagem definir a aparência.
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-2.2/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "480p",
"aspect_ratio": "16:9"
}
}'
# 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.




























