Tutorial da API Wan 3.0 Prime: texto para vídeo, primeiro/último frame e vídeo a partir de referência

TL;DR

• Wan 3.0 Prime (Wanxiang 3.0 versão acelerada) é a linha rápida do Wan 3.0 da Alibaba, com nome de modelo wan3.0-video-prime. Um único modelo faz texto para vídeo, vídeo a partir do primeiro/último frame e vídeo a partir de referência; os materiais de referência podem ser imagens, áudio, ou até mesmo um documento ou uma página web. Cada vídeo tem de 2 a 30 segundos e inclui áudio por padrão. Abra a página do modelo para gerar online.
• Cobrança por segundo: 480P a $0.0875 por segundo, 720P a $0.18, 1080P a $0.36. 5 segundos em 480P custam apenas $0.4375.
• Duas armadilhas: a resolução deve ser escrita em MAIÚSCULAS 480P / 720P / 1080P, e o padrão é 1080P; o Prime não aceita vídeo de referência.

Veja o resultado primeiro

Texto para vídeo, 480P, 5 segundos, com áudio (ative o som para ouvir a chuva, o tráfego e o chiado da grelha):

Rain streaking down a narrow neon-lit alley at night; a slow dolly-forward past
steaming street-food stalls, magenta and cyan reflections rippling in the wet
pavement, a tabby cat darting between crates mid-shot. Ambient sound: steady
rain, distant traffic hiss, the sizzle of a grill and a low synth drone.

Gerar com este prompt → (5 segundos, 480P, 16:9, com áudio)

wan3.0-video-prime, 480P, 5 segundos, com áudio, $0.4375.

Vídeo a partir de referência: envie uma imagem de uma estatueta de raposa de cerâmica e faça-a mover-se, mantendo a aparência inalterada.

Bring the referenced ceramic fox figurine to life: it slowly turns its head
toward camera, blinks, and tilts with a curious expression; subtle idle
breathing, a light breeze stirring the tiny scarf, soft studio key light on a
clean seamless backdrop, smooth loopable motion.

Gerar com este prompt → (envie a sua imagem de referência, 5 segundos, 480P, 9:16)

wan3.0-video-prime, imagem de referência, 480P, 5 segundos, 9:16, $0.4375.

curl: o primeiro vídeo

5 segundos em 480P, $0.4375:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "input": {
      "prompt": "一只橘猫趴在洒满阳光的窗台上打哈欠，尾巴轻轻摆动，镜头缓慢推近，暖色调",
      "resolution": "480P",
      "duration": 5,
      "aspect_ratio": "16:9",
      "audio": false
    }
  }'

Após receber data.taskId, use GET /v1/tasks/{taskId} para verificar se status é success e, em seguida, baixe output[0].url.

Python: submeter, consultar, baixar

# pip install requests; primeiro export HIAPI_KEY=sua_chave
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(timeout_s=900, **inp):
    # Ao reenviar a mesma tarefa, use a mesma Idempotency-Key para evitar cobrança duplicada
    r = requests.post(API, json={"model": "wan3.0-video-prime", "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# Vídeo a partir de referência: anime o produto da imagem de referência, 480P 5 segundos ($0.4375)
url = generate(
    prompt="让参考图里的香水瓶在黑色大理石上缓慢旋转，侧逆光扫过瓶身，镜头缓慢推近",
    reference_image_urls=["https://your-cdn.example.com/perfume.jpg"],
    resolution="480P", duration=5, aspect_ratio="9:16", audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Três formas de uso

Uso	O que enviar	Observação
Texto para vídeo	Envie apenas prompt
Primeiro/último frame	first_frame_url, podendo adicionar last_frame_url	Não pode ser usado junto com materiais de referência
Vídeo a partir de referência	reference_image_urls (até 10 imagens), reference_audio_urls (até 5 trechos, deve ser usado junto com imagens), reference_file_urls ou reference_link_urls (até 1 de cada, escolha um)	No prompt, use Image1, Audio1 em ordem para referenciar os materiais

Documento e página web de referência são diferenciais do Wan 3.0: é possível entregar ao modelo um PDF de diretrizes de marca ou o link de uma página de produto e deixá-lo criar o vídeo com base nas informações. A página web deve abrir sem necessidade de login.

Visão geral dos parâmetros

Parâmetro	Valores	Observação
prompt	String, obrigatório	Descreva cena, ação, câmera, iluminação e som
resolution	480P / 720P / 1080P, padrão 1080P	MAIÚSCULAS, determina diretamente o preço
duration	Inteiro de 2 a 30, padrão 5	Unidade em segundos
aspect_ratio	adaptive 16:9 4:3 1:1 3:4 9:16, padrão adaptive	adaptive escolhe automaticamente com base nos materiais e no prompt
audio	Padrão true	Faixa de áudio sincronizada, sem custo adicional
seed	0–2147483647	Semente fixa para facilitar a reprodução
first_frame_url / last_frame_url	Endereço da imagem	Primeiro/último frame
reference_image_urls etc.	Ver tabela acima	Vídeo a partir de referência

Calcule o custo

Duração	480P ($0.0875/s)	720P ($0.18/s)	1080P ($0.36/s)
5 segundos	$0.4375	$0.90	$1.80
10 segundos	$0.875	$1.80	$3.60
30 segundos	$2.625	$5.40	$10.80

Ajuste o prompt primeiro em 480P e, após a versão final, passe para 720P ou 1080P. Se não houver pressa, a versão padrão do Wan 3.0 (wan3.0-video) em 720P custa apenas $0.08 por segundo e ainda aceita vídeo de referência. Veja os preços completos em Preços da API Wan 3.0 Prime.

Atenção antes de ir para produção

• Use callback em vez de polling: adicione no nível superior da requisição (no mesmo nível de input) "callback": {"url": "https://seu-dominio/hiapi/callback"} e deduplique por taskId.
• Guarde o resultado a tempo: output[0].url é um link temporário.
• Reenvios com chave de idempotência: adicione Idempotency-Key no cabeçalho da requisição; reenviar com a mesma chave cria a tarefa apenas uma vez.
• Reembolso automático em caso de falha: a cobrança é feita apenas para vídeos gerados com sucesso.

Perguntas frequentes

Por que enviar 720p retorna erro?

A resolução deve ser escrita em maiúsculas. Enviar em minúsculas retorna 400: resolution: value must be one of '480P', '720P', '1080P'.

É possível enviar vídeo de referência?

O Prime não pode; ele não aceita o parâmetro reference_video_urls. Para usar vídeo de referência, mude para a versão padrão do Wan 3.0, wan3.0-video.

É possível desativar o áudio?

Sim, audio: false. O padrão é ativado e o preço não muda.

Qual é a diferença entre o Prime e a versão padrão do Wan 3.0?

Os parâmetros e as especificações de saída são iguais; o Prime é a linha acelerada. A versão padrão também tem opção 480P ($0.04/s), mas 720P e 1080P custam mais que o dobro por segundo e não aceitam vídeo de referência.

Para mais formas de escrever prompts, veja Exemplos de prompts do Wan 3.0 Prime; para comparar com a geração anterior, veja Como escolher entre Wan 3.0 e Wan 2.7. Você também pode ir à página do modelo e gerar o do beco chuvoso.