API Wan 3.0 para Geração de Vídeo

Acesse o Wan 3.0 através da API aberta e independente da GoEnhance para geração de texto para vídeo, primeiro quadro e quadros inicial-final. Envie uma solicitação assíncrona, mantenha o img_uuid retornado e, em seguida, faça polling ou receba callbacks até que a tarefa seja concluída ou falhe.
Obter Chave de API
Cena cinematográfica em movimento representando a geração de vídeo Wan 3.0

Escolha o modo de solicitação de API Wan 3.0 correto

Geração orientada por prompt e quadros

POST para https://api.goenhance.ai/api/v1/videos/generations com model: wan-3-0. Use apenas um prompt, adicione image_url para um primeiro quadro ou adicione image_end_url junto com ele para um quadro final.
Paisagem cinematográfica varrida pelo vento ilustrando vídeo orientado por prompt

Uma rota separada para materiais de referência

Use model: wan-3-0-refs para imagens, vídeos, áudio, um documento ou uma página da web de referência ordenados. Não misture materiais de referência com entradas de primeiro ou último quadro; os modos são mutuamente exclusivos.
Cena cinematográfica atmosférica representando geração orientada por referência
Valide os campos documentados antes que uma tarefa entre no seu pipeline de vídeo.

Recursos e campos de solicitação da API Wan 3.0

Modelo e prompt obrigatórios

Para a rota padrão, defina model como wan-3-0 e forneça um prompt de texto.

Primeiro e último quadros

Adicione image_url para um primeiro quadro. image_end_url é opcional, mas deve ser usado em conjunto com image_url.

Proporção de tela

Escolha adaptável, 16:9, 4:3, 1:1, 3:4 ou 9:16. O padrão documentado é adaptável; 21:9 não está listado.

Duração

Escolha qualquer número inteiro de 2 a 30 segundos. O padrão documentado é 5 segundos.

Resolução e áudio

Selecione 480p, 720p ou 1080p; a GoEnhance usa 720p por padrão. generate_audio é verdadeiro por padrão e não acarreta custo extra de geração.

Seed e callback

Opcionalmente, defina um seed de 0 a 2147483647 e forneça uma custom_callback_url HTTPS pública para atualizações de status.
Ambas as rotas do Wan 3.0 usam as mesmas taxas por segundo. Estime o custo como a taxa selecionada multiplicada pela duração solicitada.

Preços da API Wan 3.0

Preço de 480p

2,91 tokens por segundo gerado, equivalente a $0.0582 por segundo na taxa documentada de $0.02 por token.

Preço de 720p

5,82 tokens por segundo gerado, equivalente a $0.1164 por segundo na taxa documentada de $0.02 por token.

Preço de 1080p

11,64 tokens por segundo gerado, equivalente a $0.2328 por segundo na taxa documentada de $0.02 por token.

Integre a API Wan 3.0 em seis etapas

1

1. Crie uma chave de API

Crie uma chave GoEnhance e envie-a como um token bearer no cabeçalho de Autorização.
2

2. Selecione um modo de entrada

Use wan-3-0 para prompt ou primeiro/último quadros, ou wan-3-0-refs para materiais de referência.
3

3. Valide a solicitação

Verifique os campos obrigatórios, dependências de quadros, duração, resolução, proporção e limites de referência antes do envio.
4

4. Envie a tarefa

Faça um POST para /api/v1/videos/generations e persista o img_uuid retornado.
5

5. Acompanhe o status

Consulte GET /api/v1/jobs/detail ou receba atualizações em uma URL de retorno de chamada HTTPS pública.
6

6. Gerencie a conclusão

Processe o sucesso e a falha de forma idempotente, verifique o ativo retornado e contabilize os tokens reembolsados quando uma tarefa de referência falhar a montante.
Obter chave de API
Crie fluxos de trabalho de geração de vídeo repetíveis em torno de entradas explícitas e estados de tarefa terminais.

Casos de uso do desenvolvedor para a API Wan 3.0

Variantes de vídeo de campanha

Gere clipes conceituais curtos a partir de prompts estruturados para revisão criativa e montagem posterior.

Movimento de produto

Anime um primeiro quadro aprovado enquanto seu aplicativo controla o prompt, o enquadramento e o tratamento da conclusão.

Transições de storyboard

Forneça o primeiro e o último quadros para explorar o movimento entre dois momentos visuais aprovados.

Criação baseada em referência

Use a rota de referência separada quando um fluxo de trabalho depender de imagens, vídeos, áudio, um documento ou uma página da web ordenados.

Pipelines de conteúdo localizado

Parametrize prompts para variantes regionais sem alterar o manipulador de tarefas assíncronas.

Pré-visualização

Transforme descrições concisas de cenas em conceitos de movimento revisáveis antes da produção completa.
Respostas para perguntas comuns sobre preços, modo de solicitação, validação, status da tarefa e API da Alibaba.

Perguntas frequentes sobre a API Wan 3.0

Qual é o endpoint da API Wan 3.0 no GoEnhance?

Envie solicitações para POST https://api.goenhance.ai/api/v1/videos/generations. Use model: wan-3-0 para geração de prompt ou primeiro/último quadro e wan-3-0-refs para materiais de referência.

Como funciona a precificação da API Wan 3.0?

A precificação é por segundo gerado: 2,91 tokens/s ($0.0582/s) a 480p, 5,82 tokens/s ($0.1164/s) a 720p e 11,64 tokens/s ($0.2328/s) a 1080p. Multiplique a taxa selecionada pela duração.

Posso misturar entradas de primeiro quadro com materiais de referência?

Não. Os dois modos do Wan 3.0 são mutuamente exclusivos. Use wan-3-0 com image_url e image_end_url opcional, ou use wan-3-0-refs com entradas de referência.

Quais valores de duração e resolução são suportados?

A duração aceita qualquer número inteiro de 2 a 30 segundos, com padrão de 5. A resolução aceita 480p, 720p ou 1080p, com padrão de 720p no GoEnhance.

O que a rota de referência pode aceitar?

A rota de referência suporta até 10 imagens, até 5 vídeos, até 5 arquivos de áudio ou um documento ou página da web pública. É necessária pelo menos uma entrada de referência, e as entradas de documento e página da web são mutuamente exclusivas.

Existem limites combinados para vídeos de referência?

Sim. Os vídeos de referência podem totalizar até 15 segundos, e sua duração combinada somada à duração da saída solicitada não deve exceder 30 segundos. Uma falha upstream após o envio reembolsa os tokens de acordo com a documentação atual do GoEnhance.

Como sei quando uma tarefa foi concluída?

Persista o img_uuid e faça polling em GET /api/v1/jobs/detail, ou forneça uma custom_callback_url HTTPS pública. Respostas de callback que não sejam 200 são tentadas novamente até três vezes.

Esta é a API oficial Wan da Alibaba?

Não. Wan está associado à Alibaba. Esta página descreve o acesso independente de terceiros através do GoEnhance e não implica afiliação, parceria, endosso ou que o GoEnhance tenha desenvolvido o Wan 3.0.

Comece a desenvolver com a API Wan 3.0