Introdução
Wan 3.0 Pro Texto para vídeo escreve uma cena a partir de um prompt e a entrega em 1080p, 2K ou 4K, com 2 a 30 segundos e o áudio gerado no mesmo arquivo. prompt é o único campo obrigatório e aceita até 20.000 caracteres. Um render nativo do Wan 3.0 chega no máximo a 1080p, então os níveis 2k e 4k são ampliados a partir desse render, e não desenhados nesses tamanhos. Este endpoint não tem nível 480p nem 720p; esses tamanhos ficam com o Wan 3.0.
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
Três tamanhos de entrega a partir de um render nativo
resolution aceita 1080p (padrão), 2k ou 4k. Os dois níveis maiores esticam o que o modelo desenhou em vez de desenhar mais, então servem para material que vai ser recortado, rastreado ou projetado, e só são tão bons quanto o render de base. Encontre a cena em 1080p primeiro e trate o 4K como etapa de entrega.
A expansão de prompt já vem ligada
Nesta família, enable_prompt_expansion é true por padrão. Ela completa um briefing curto, o que ajuda enquanto você ainda esboça, mas reescreve um briefing detalhado. Quando o seu prompt já for uma descrição precisa da cena, mude o campo para false para que a redação que você ajustou seja a que roda.
Formato adaptável, a menos que você fixe um
aspect_ratio é adaptive por padrão, então o modelo escolhe o quadro. Informe 16:9, 4:3, 1:1, 3:4 ou 9:16 quando o formato de entrega estiver definido: o exemplo da cerca pede 9:16 para um quadro vertical, enquanto os exemplos do perfume, do preto e branco e da tatuagem fixam 16:9.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Sujeito, uma ação, um movimento de câmera, e então luz e som. Em 4K um briefing vago custa dinheiro de verdade, então escreva o plano, não um clima. pelo menos 1 caracteres · no máximo 20000 caracteres |
resolution | Não | 1080p, 2k ou 4k, padrão 1080p. |
aspect_ratio | Não | 16:9, 4:3, 1:1, 3:4, 9:16 ou adaptive. Padrão adaptive, que deixa o modelo escolher; nomeie uma proporção 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
Filmes de perfume e beleza com luz dura
O exemplo do perfume é um spot de cinco segundos em câmera lenta: uma mulher adulta com um vestido preto de costas abertas se vira de uma janela castigada pela chuva enquanto uma única luz principal dura percorre a coluna dela e gotas saltam do cabelo, com uma nota grave de violoncelo e chuva na trilha. Tecido brilhante, uma fonte dura única e partículas pequenas e rápidas são as primeiras coisas a se degradar na ampliação, então confira exatamente isso em uma entrega 2K ou 4K.
Tecido movido por uma única força externa
Dois exemplos dirigem a roupa por meio de uma única força, em vez de descrever como ela cai. No filme de moda em preto e branco, três metros de chiffon de seda diante de um ventilador industrial chicoteiam o corpo e se enrolam em um ombro sob uma luz dura contra fundo preto. No exemplo da cerca, o jato de um avião pousando cola a roupa de duas pessoas contra o corpo. Nomear a força dá ao tecido uma causa para seguir.
Guia de prompt e dicas práticas
Explore em 1080p e renderize de novo a semente escolhida
Encontre a cena em 5 segundos e 1080p com seed fixo, mude um campo por repetição e só então envie o mesmo prompt com a mesma semente e resolution em 4k. Mudar resolução e texto na mesma repetição impede saber qual dos dois mexeu no resultado.
Escreva a cena, não um clima
Sujeito, uma ação, um movimento de câmera, depois luz e som. O prompt do estúdio de tatuagem é um bom modelo: velas e uma luminária de mesa como única luz, mãos de luva sombreando um desenho nas costelas, uma careta, uma expiração lenta e um sorriso por cima do ombro, a máquina zumbindo, uma aproximação bem lenta. Em 4K, um briefing vago é um jeito caro de descobrir o que você queria dizer.
Diga quais sons você quer ouvir
O som é gerado junto com a imagem, então liste as fontes: o spot de perfume pede "low cello note and rain", e o filme do ventilador, "the roar of the fan and snapping cloth". Mude generate_audio para false quando um compositor for fazer a trilha. A família aceita prompts sem censura sem declaração por requisição; consentimento, direitos, idade e lei local de todas as pessoas retratadas são responsabilidade sua.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "1080p",
"aspect_ratio": "adaptive",
"duration_seconds": 5
}
}'
# 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.



























