Alibaba

Wan 3.0 Video

wan3.0-video-prime

Nova geração de modelos de geração de vídeo da série Wan da Alibaba, capaz de produzir clipes de aproximadamente 30 segundos em 1080p por vez, com suporte à consistência do sujeito a partir de materiais de referência e suporte inédito a entradas estruturadas no formato de documento

wan3.0-video wan3.0-video-prime

Experimentar wan3.0-video-prime

Entrada

Saída

video

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

wan3.0-video-prime per second

Especificações	Preço unitário
480P	$0.0875
720P	$0.180
1080P	$0.360

Posicionamento

wan3.0-video-prime é a linha de alta qualidade do Wan 3.0 Video voltada para referência para vídeo (reference-to-video), chamada por meio da interface unificada do HiAPI.ai. Ele recebe materiais de referência como imagens, áudios, documentos e páginas web e, combinados com o prompt, gera vídeos com áudio de até 30 segundos e resolução máxima de 1080P, com suporte a controle de primeiro e último quadro, duração e proporção de tela. É indicado para desenvolvedores e equipes de conteúdo que precisam manter a consistência do sujeito a partir de materiais de marca ou produto e produzir o vídeo final diretamente.

Destaques principais

Geração multimodal guiada por materiais de referência — uma única chamada pode combinar até 10 imagens, 5 trechos de áudio e referências de documento ou página web, citados no prompt na ordem do array como Image1, Audio1 etc.
Duração de 2 a 30 segundos em uma única geração — o parâmetro duration define diretamente a duração da saída; narrativas longas não precisam ser fragmentadas e remontadas para gerar o clipe completo de uma vez.
Até 1080P com níveis selecionáveis — oferece três resoluções (480P, 720P e 1080P) e seis proporções de tela, permitindo equilibrar qualidade e custo a cada geração.
Faixa de áudio sincronizada e controle de primeiro/último quadro — a saída inclui áudio sincronizado por padrão, que pode ser desativado; imagens de primeiro e último quadro restringem os quadros inicial e final da câmera.

Descrição das capacidades

Geração com consistência de referência: usa imagens, áudios e outros materiais de referência para fixar o sujeito e o estilo, mantendo a aparência do mesmo personagem ou produto ao longo de todo o vídeo e reduzindo retrabalho na pós-produção.

Entrada de materiais estruturada: aceita um documento ou uma página web sem login como referência e, junto com o prompt, converte o conteúdo do material em quadros de vídeo explicativo.

Duração e proporção controláveis: duração de 2 a 30 segundos e seis proporções de tela à escolha; o modo adaptive acompanha automaticamente os materiais de entrada e o prompt, facilitando a adaptação a posicionamentos horizontais e verticais.

Restrição de câmera por primeiro e último quadro: permite especificar separadamente as imagens de primeiro e último quadro, restringindo o ponto de partida e de chegada da câmera, ideal para vídeos finais que exigem abertura e encerramento precisos.

Reprodutibilidade e chave de áudio: reproduz o mesmo resultado com seed fixa, e o parâmetro audio controla se a faixa de áudio sincronizada é gerada, facilitando a geração em lote e a comparação de versões.

Cenários de uso

Materiais de marca ou produto convertidos em filme publicitário — insira imagens do produto e um prompt com os pontos de venda para obter um filme curto com áudio que mantém a aparência do produto, usado em páginas de detalhes de e-commerce e em anúncios em redes sociais.
Trechos narrativos de personagem com referências multimodais — use imagens do personagem e referências de áudio para gerar trechos contínuos de até 30 segundos, como segmentos de enredo ou de séries curtas.
Materiais convertidos em vídeo explicativo — envie um documento ou link de página web para gerar quadros explicativos sobre o tema, usados em treinamentos internos e apresentações de produto.
Complemento de câmera com quadros inicial e final definidos — forneça duas imagens de quadros-chave, inicial e final, para gerar uma transição de duração controlável e integrá-la ao fluxo de edição de pós-produção.

Limitações e recomendações de escolha

A cobrança é por segundo de saída; quanto maiores a resolução e a duração, maior o custo, então combinações de vídeos longos com alta qualidade exigem estimativa prévia. O resultado depende fortemente do prompt; descrições pouco claras de sujeito, ação, câmera e estilo geram variações maiores. Os modos de material de referência e de primeiro/último quadro não podem ser misturados, e cada chamada aceita apenas um documento ou uma página web de referência. Para clipes diários mais curtos e leves, pode-se optar pela linha padrão da mesma família; para tarefas em lote com alta exigência de parâmetros fixos e reprodutibilidade, recomenda-se fixar a seed antes de ampliar a escala.

Novidades

Ver o changelog →

Novo modelo Modelo de geração de vídeo wan3.0-video-prime já disponível Nov 3, 2026

Perguntas frequentes

Ver todas as perguntas →

Que tipo de modelo de vídeo é o Wan 3.0 Video?

Ele tem o Prompt como núcleo e também pode incluir quadros inicial e final ou imagens, vídeos e áudios de referência; diferentes formas de controle devem ser combinadas de acordo com o contrato de parâmetros atual.
Quais especificações de saída o Wan 3.0 Video suporta?

Suporta de 2 a 30 segundos, com resoluções incluindo 480P, 720P e 1080P, e proporções de tela incluindo adaptive, 16:9, 4:3, 1:1, 3:4 e 9:16.
É possível gerar voz ou usar referências de áudio?

Referências opcionais de imagem, vídeo, áudio, arquivo e link; suporta áudio sincronizado
Como o Wan 3.0 Video é cobrado?

A cobrança é feita com base na duração da saída e na faixa em tempo real; diferenças decorrentes da resolução, do modo ou das opções de áudio seguem os preços da página e o registro da tarefa.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: wan3.0-video-prime

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para wan3.0-video-prime e a rota default — veja a tabela de parâmetros abaixo.

seedintegerOpcionalmin 0max 2147483647

Semente aleatória; passe um valor fixo quando precisar de saídas reproduzíveis; se não for passado, o servidor gera aleatoriamente.

audiobooleanOpcionalPadrão: true

Se o vídeo de saída deve incluir uma faixa de áudio sincronizada, valor booleano, padrão true.

promptstringObrigatóriominLength 1maxLength 20000

Prompt que descreve a cena, o movimento, a câmera, a iluminação e o som; no modo de referência, refira-se aos materiais correspondentes como Image1, Audio1 etc. na ordem do array.

durationintegerOpcionalPadrão: 5min 2max 30

Duração do vídeo de saída, em segundos, intervalo de 2 a 30, padrão 5.

resolutionstringOpcionalPadrão: "1080P"

Resolução do vídeo de saída, padrão 1080P.

Opções:480P720P1080P

aspect_ratiostringOpcionalPadrão: "adaptive"

Proporção de aspecto do quadro de saída, padrão adaptive, ou seja, adapta-se automaticamente à mídia de entrada e ao prompt.

Opções:adaptive16:94:31:13:49:16

last_frame_urlstringOpcional

Uma URL de imagem acessível publicamente, usada como frame final do vídeo; deve ser usada em conjunto com first_frame_url.

first_frame_urlstringOpcional

Uma URL de imagem acessível publicamente, usada como frame inicial do vídeo; não pode ser usada ao mesmo tempo que o array de materiais de referência.

reference_file_urlsarrayOpcionalmaxItems 1

Array de URLs de documentos ou apresentações de referência, no máximo 1, e deve ser acessível publicamente.

Array [ string ]

reference_link_urlsarrayOpcionalmaxItems 1

Array de URLs de páginas web de referência, no máximo 1, e a página deve ser acessível publicamente sem necessidade de login.

Array [ string ]

reference_audio_urlsarrayOpcionalmaxItems 5

Array de URLs de áudio de referência, no máximo 5 trechos WAV ou MP3, cada trecho com 1 a 15 segundos, e deve ser usado em conjunto com imagens ou vídeos.

Array [ string ]

reference_image_urlsarrayOpcionalmaxItems 10

Array de URLs de imagens de referência, no máximo 10 imagens, para geração de referência geral.

Array [ string ]

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan3.0-video-prime",
  "input": {
    "audio": true,
    "prompt": "…",
    "duration": 5,
    "resolution": "1080P",
    "aspect_ratio": "adaptive"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "wan3.0-video-prime",
    input: {
      "audio": true,
      "prompt": "…",
      "duration": 5,
      "resolution": "1080P",
      "aspect_ratio": "adaptive"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "wan3.0-video-prime",
        "input": {
          "audio": True,
          "prompt": "…",
          "duration": 5,
          "resolution": "1080P",
          "aspect_ratio": "adaptive"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}