Introdução
Wan 3.0 Pro Prime Texto para vídeo gera uma cena de 2 a 30 segundos a partir de um prompt e a entrega em 1080p, 2K ou 4K com o áudio no mesmo arquivo. A lista de campos é exatamente a do Wan 3.0 Pro Texto para vídeo, mas o render base é o Wan 3.0 Prime, que a Alibaba posiciona como a versão de alta velocidade com as mesmas capacidades. Um render nativo do Prime chega no máximo a 1080p, então os níveis 2k e 4k são ampliados a partir dele, e não renderizados de forma nativa.
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 Prime Texto para vídeo |
| Uma imagem inicial aprovada fixa sujeito e composição; a instrução direciona o movimento seguinte. | Wan 3.0 Pro Prime 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 Prime Referências para vídeo |
Recursos e destaques
O mesmo corpo do Wan 3.0 Pro
prompt (até 20.000 caracteres) é o único campo obrigatório; resolution tem padrão 1080p, aspect_ratio tem padrão adaptive e enable_prompt_expansion tem padrão true. Como o contrato é idêntico, um único corpo JSON roda no Pro e no Pro Prime trocando só o nome do modelo, então envie uma cena de teste aos dois com a mesma semente antes de fechar um projeto com um deles.
Enquadramento escrito no briefing
O exemplo da cripta gasta um terço do prompt só com enquadramento: a cabeça inteira no quadro, espaço acima do cabelo, o quadro cortando na cintura, o rosto visível o tempo todo. Em um close, a falha comum é o modelo cortar o rosto para fora do próprio quadro, e nomear o enquadramento resolve isso. A luz das velas é a única principal, e o áudio — chamas tremulando, uma porta de ferro ao longe — chega na mesma passada.
Movimento sem ponto de apoio
O exemplo subaquático não tem chão de referência: um vestido de seda carmim desabrochando enquanto a pessoa afunda, cabelo aberto em leque, bolhas saindo das pontas dos dedos e uma câmera que faz um arco e inclina ao mesmo tempo. Ele não define resolução, então roda no padrão 1080p. Cenas em que nada assenta são as que mais aproveitam um nível de entrega maior.
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.234 / segundo |
| $0.252 / segundo |
| $0.279 / segundo |
Casos de uso
Luz colorida em movimento em quadro vertical
O exemplo da aurora pede uma luz verde correndo pela pele e pelo cabelo de duas pessoas que dividem um cobertor sobre um lago congelado, em 9:16. Luz colorida se movendo sobre a pele é onde banding e ruído de cor aparecem primeiro, então encomende 2K ou 4K para um sujeito assim só quando a cena realmente pedir; um sujeito parado em 4K só rende um arquivo maior.
Cenas com câmera na mão e luz disponível
O exemplo da balsa noturna é simples de propósito: enquadramento documental com câmera na mão, um holofote de convés e luzes distantes do porto, dois homens adultos na amurada de popa encostando as testas e se beijando enquanto a esteira ferve lá embaixo. Não há flag de conteúdo para definir, já que toda cena é enviada como qualquer outro prompt; consentimento, direitos, idade e lei local continuam sendo responsabilidade sua.
Guia de prompt e dicas práticas
Explore pequeno, entregue grande
Ajuste o prompt em 1080p e 5 segundos com seed fixo. Quando a tomada funcionar, reenvie exatamente o mesmo corpo com resolution em 4k. Mudar resolução e semente juntas muda duas coisas de uma vez e esconde qual delas mexeu no resultado.
Em um arquivo ampliado, confira primeiro a luz dura
Uma única fonte dura à noite — uma lâmpada pendurada, um holofote de convés — é onde o material ampliado mostra primeiro seus limites: banding na queda de luz, pele de cera, tecido molhado virando uma mancha cinza. Confira essas áreas no arquivo 2K ou 4K entregue antes de corrigir cor ou montar uma sequência com ele.
Feche o texto antes do render final
Nesta família a expansão de prompt vem ligada e reescreve briefings detalhados. Desligue enable_prompt_expansion quando o prompt já soar como uma descrição precisa da cena, para que a versão ajustada seja a que roda. Escreva o sujeito, uma ação, um movimento de câmera e depois luz e som.
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-prime/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.



























