Os mesmos campos do estúdio
Um trabalho precisa de um prompt. Os campos opcionais cobrem duração, resolução, proporção, enable_audio, image, last_image e mídias de referência.
API do Wan 3.0
API do Wan 3.0
A página da API do Wan 3.0 é para desenvolvedores que querem os mesmos campos de geração do estúdio: prompt, duração, áudio, quadros de início e fim, além de referências. Hoje, o caminho suportado para clientes é uma conta autenticada no wan30.art. Valide um plano no estúdio e depois reutilize a mesma estrutura de requisição com sua chave de API.
A autenticação fica na sua chave
Envie a chave de API do usuário no cabeçalho Authorization. O servidor do site anexa as credenciais internas do serviço. Os clientes de navegador nunca falam diretamente com o worker de origem.
Créditos antes de renderizar
O saldo é verificado na criação da tarefa. Trabalhos com falha são reembolsados. Duração e áudio são os principais custos, então calcule a opção de 30 segundos antes de um lote.
Para que serve a API do Wan 3.0
Use quando uma ferramenta, um agente ou um backend precisar de trabalhos repetíveis do Wan 3.0: texto para vídeo, imagem para vídeo ou referência para vídeo. O JSON abaixo é o contrato, não um ambiente público de testes sem autenticação. Crie uma conta, mantenha a sessão ou a chave de API privada e consulte o status até o clipe ficar pronto.
Comece no estúdio e depois automatize
Se ainda está explorando o Wan 3.0, gere no navegador primeiro. Quando o prompt e a duração estiverem estáveis, copie esses campos para a sua integração. Não fixe no código os nomes de host internos do worker que aparecem nesta página.
Os mesmos campos do estúdio
{
"prompt": "A slow product orbit, then a pack-shot finish",
"model": "wan-3.0",
"type": "text-to-video",
"duration": 12,
"resolution": "1080p",
"aspect_ratio": "16:9",
"enable_audio": true
}A autenticação fica na sua chave
{
"prompt": "Hold identity, then walk into a brighter hallway",
"model": "wan-3.0",
"type": "image-to-video",
"image": "https://example.com/first-frame.jpg",
"last_image": "https://example.com/last-frame.jpg",
"duration": 8,
"enable_audio": false
}Executar um trabalho do Wan 3.0
Criar uma chave de conta
Entre, abra o estúdio uma vez e guarde a chave de API da sua conta. Os créditos precisam cobrir a duração solicitada.
Enviar um payload de geração por POST
Envie o prompt e, opcionalmente, duração, áudio, image, last_image ou referências. A resposta retorna um task_id.
Consultar o status e baixar
Consulte o status com o task_id até o trabalho concluir ou falhar. Guarde a URL do resultado do seu histórico, sem deduzir um CDN de terceiros.
Perguntas frequentes da API do Wan 3.0
Existe uma API pública do Wan 3.0 hoje?
Trabalhos programáticos usam a chave de API da sua conta no wan30.art e o fluxo autenticado de geração e status do site. Não há endpoint público anônimo neste domínio.
Qual duração a API pode solicitar?
A geração do Wan 3.0 aceita 2–30 segundos. Calcule os trabalhos mais longos antes de executá-los em loop. A interface de geração do navegador pode mostrar apenas um intervalo menor durante os testes.
A API suporta áudio e quadros finais?
Sim. enable_audio ativa a geração de trilha sonora nativa. last_image é o quadro final opcional para imagem para vídeo. As listas de referência cobrem imagens, vídeos e áudios extras.
Onde vejo o custo em créditos?
Na página de preços. Os créditos dependem da duração, da resolução e das opções. Uma tarefa com falha deve devolver os créditos automaticamente.
Posso chamar diretamente o host do modelo de origem?
Não. O navegador e as integrações de cliente devem chamar apenas o wan30.art. O site faz proxy da geração para que as chaves e a cobrança fiquem no servidor.
Valide o plano e depois automatize
Use primeiro o estúdio do Wan 3.0. Reutilize os mesmos campos da API quando o prompt estiver estável.