MiniMax-M3.1-Flash and DeepSeek-V4.1-Flash-1017 are now live on CometAPI →
guide/Pesquisa CometAPI

Como usar a API Wan 2.7: guia completo para desenvolvedores

Aprenda a usar a Wan 2.7 API via CometAPI para geração de texto para vídeo e imagem para vídeo, com exemplos, preços, comparações e melhores práticas.

CometAPI
Mia MarenEquipe de pesquisa de modelos e API de IA
Atualizado Sep 3, 2026 22 min de leitura
Como usar a API Wan 2.7: guia completo para desenvolvedores
Use este padrão

Faça a primeira chamada à API.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

Resposta rápida

Wan 2.7 é a suíte multimodal de geração de vídeo da Alibaba para fluxos de trabalho de texto-para-vídeo, imagem-para-vídeo, geração guiada por referência e edição. Por meio do Wan 2.7 no CometAPI, desenvolvedores usam o ID de modelo wan2.7 com o endpoint assíncrono POST /v1/videos. A integração tem três fases operacionais: enviar uma tarefa, consultar o ID de vídeo retornado e baixar o MP4 concluído. A rota live oferece saída em 720p e 1080p e lista o preço por segundo, portanto a duração e a resolução determinam o custo estimado de geração. Comece com uma solicitação de 5 segundos em 720p de texto-para-vídeo, valide o fluxo e só então adicione referências de imagem ou resolução mais alta depois que a rota básica estiver funcionando.

Importante: Este guia cobre o Wan 2.7 Video através do CometAPI. Ele não descreve o modelo separado de geração de imagens Wan, portanto especificações somente de imagem, como saída de imagem estática em 4K, não são tratadas como capacidades do Wan 2.7 Video.

Principais pontos

  • O CometAPI expõe o Wan 2.7 por meio de um endpoint de vídeo assíncrono no estilo OpenAI em vez de uma resposta de chat síncrona.
  • A rota usa o ID de modelo wan2.7 e POST /v1/videos.
  • Uma integração completa deve preservar o ID de vídeo retornado, consultar o endpoint de status, lidar com falhas terminais e baixar o MP4 somente após o sucesso.
  • A API nativa de texto-para-vídeo do Wan 2.7 da Alibaba suporta 720P e 1080P com duração de 2-15 segundos; a rota do CometAPI utiliza nomes de campos unificados próprios.
  • Fluxos de trabalho de imagem-para-vídeo, primeiro/último quadro e continuação existem na família nativa do modelo Alibaba, mas campos avançados disponíveis através da rota unificada devem ser verificados na documentação da rota live.
  • A evidência mais forte em benchmarks públicos é para vídeo-para-vídeo: o Wan 2.7 liderou a categoria Design Arena. Esse resultado não deve ser generalizado para todas as tarefas de texto-para-vídeo ou imagem-para-vídeo.
  • A métrica de produção mais útil é o custo por clipe aprovado, não apenas o preço por segundo gerado.

O que é o Wan 2.7?

Wan 2.7 em termos simples para desenvolvedores

Wan 2.7 não é apenas um checkpoint de prompt-para-vídeo. A Alibaba descreve uma família de vídeo em quatro partes abrangendo Wan2.7-t2v, Wan2.7-i2v, Wan2.7-r2v e Wan2.7-videoedit. Juntas, essas variantes cobrem geração a partir de texto, animação a partir de imagens, controle de sujeito ou estilo guiado por referência e transformação de vídeo existente. Isso importa para o design de aplicações: um simples clipe de marketing pode usar apenas texto-para-vídeo, enquanto um pipeline de produção com consistência de personagem pode precisar de entradas de referência, quadros ancorados, orientação por áudio e edição iterativa.

No CometAPI, a rota comprime intencionalmente a nomenclatura específica do provedor no ID de modelo do cliente wan2.7. A capacidade de geração subjacente permanece a do Wan 2.7, mas autenticação, caminhos de endpoint e nomes de parâmetros diferem da API nativa da Alibaba Cloud.

Especificações técnicas do Wan 2.7

EspecificaçãoWan 2.7 Video
ProvedorAlibaba / Wan
ID de modelo no CometAPIwan2.7
IDs nativos de texto-para-vídeowan2.7-t2v, wan2.7-t2v-2026-06-12
ID nativo de imagem-para-vídeowan2.7-i2v-2026-04-25
Entradas principaisTexto; imagem, áudio ou vídeo em fluxos de trabalho suportados
Saída principalVídeo gerado com comportamento de áudio suportado
ModosT2V, I2V, R2V, edição de vídeo, primeiro/último quadro, continuação
Resolução720P e 1080P
Duração T2V2-15 segundos; padrão de 5 segundos
Proporções T2V16:9, 9:16, 1:1, 4:3, 3:4
Limite de prompt5.000 caracteres para T2V nativo do Wan 2.7
Limite de prompt negativo500 caracteres
Formatos e limites de áudioWAV/MP3; 2-30 segundos; até 15 MB
InvocaçãoAssíncrona
Arquitetura / contagem de parâmetrosNão confirmada de forma abrangente na documentação oficial da API

Especificação de fronteira: Algumas páginas de catálogo descrevem uma arquitetura ou contagem de parâmetros, mas a documentação oficial da API de vídeo da Alibaba não publica uma especificação de arquitetura completa para cada variante do Wan 2.7. A redação editorial mais segura é que a contagem completa de parâmetros e a arquitetura não são divulgadas de forma abrangente.

O que o Wan 2.7 pode fazer?

Texto-para-vídeo com prompts multishot cronometrados.

O Wan 2.7 pode interpretar mudanças de tomada escritas diretamente em um prompt. Um desenvolvedor pode descrever Tomada 1, Tomada 2 e Tomada 3 com intervalos de tempo em vez de depender de um campo separado de controle de tomadas. Isso torna o próprio prompt um storyboard compacto.

Controle de primeiro e último quadro.

O fluxo de trabalho nativo de imagem-para-vídeo aceita mídia de primeiro quadro e de último quadro para que o modelo sintetize o movimento entre dois âncoras visuais. Isso é útil para transições de produto, mudanças de pose e morfagem de cena.

Continuação de vídeo.

Uma entrada nativa do tipo first_clip condiciona a próxima porção do vídeo. Nesse fluxo de trabalho, a duração deve ser interpretada de acordo com as regras da tarefa do provedor, então as aplicações não devem assumir que significa sempre apenas o segmento recém-gerado.

Geração guiada por áudio.

A Alibaba documenta o áudio como fonte de orientação para temporização e comportamento de sincronização labial. Sem um ativo de áudio enviado, o modelo pode gerar música de fundo ou efeitos sonoros correspondentes. Áudio mais longo que o vídeo solicitado é truncado; áudio mais curto deixa o restante do vídeo em silêncio.

Extensão de prompt, prompts negativos e marca d’água.

A API nativa suporta reescrita de prompt, prompts negativos e uma opção de marca d’água gerada por IA. Esses controles ajudam equipes a padronizar a qualidade do prompt e o comportamento de proveniência, embora campos unificados do CometAPI possam não ter mapeamento um-para-um.

O que dizem os benchmarks públicos sobre o Wan 2.7?

Modelos de vídeo não têm um único benchmark universalmente aceito equivalente ao MMLU ou SWE-bench de um LLM. Para o Wan 2.7, o sinal externo mais claro publicado é que ele liderou a categoria de vídeo-para-vídeo do Design Arena. A imagem de classificação da publicação oficial mostra o Wan 2.7 com uma classificação Elo de 1335 naquele momento. Isso sustenta uma afirmação sobre preferência em transformação e edição de vídeo; não prova liderança universal em texto-para-vídeo, imagem-para-vídeo, qualidade de áudio ou latência.

EvidênciaResultado públicoComo interpretar
Design Arena vídeo-para-vídeoPrimeiro lugar; Elo 1335 em imagem publicadaForte evidência de preferência em V2V
Especificações oficiais da API720P/1080P; 2-15 segundos para T2VFlexibilidade de produção, não ranking de qualidade
Pontuação T2V padronizadaNão divulgada publicamenteNão reivindicar liderança T2V universal
Pontuação I2V padronizadaNão divulgada publicamenteUse um teste A/B interno
Benchmark de latência ou taxa de sucessoNão padronizado publicamenteMeça na rota selecionada

Conclusão do benchmark

  • Use o resultado do Design Arena como evidência de competitividade em vídeo-para-vídeo, não como afirmação abrangente em todos os modos.
  • Não reutilize números de benchmark do Wan 2.1 como resultados do Wan 2.7.
  • Para seleção em produção, teste os mesmos prompts, ativos de origem, resolução, duração e condições de áudio em vários modelos.
  • Acompanhe taxa de aceitação humana, estabilidade de movimento, preservação de identidade, latência, taxa de falhas e custo por clipe aceito.

Por que usar o Wan 2.7 via CometAPI?

Uma API de vídeo unificada

O CometAPI expõe o modelo por meio de um ciclo de vida de vídeo assíncrono comum. A página atual do modelo Wan 2.7 publica o ID de modelo do cliente, o preço da rota e um padrão funcional de criar-consultar-baixar. Isso reduz a quantidade de código específico do provedor quando um produto precisa testar ou rotear entre vários modelos de vídeo.

POST /v1/videos GET  /v1/videos/{video_id} GET  /v1/videos/{video_id}/content

Como usar a API Wan 2.7: guia completo para desenvolvedores

O ciclo de vida criar-consultar-baixar do CometAPI para geração assíncrona de vídeo. Fonte do endpoint: CometAPI API documentation.

  • Uma única chave de API para vários modelos de vídeo suportados.
  • Um padrão consistente para criação de tarefa, recuperação de status e download de arquivo.
  • Visibilidade centralizada de uso e faturamento.
  • Menos código de aplicação atrelado à autenticação e ao esquema de resposta de um provedor.
  • Testes A/B mais rápidos porque a seleção do modelo pode mudar sem substituir todo o ciclo de vida da tarefa.

Uma nota necessária de compatibilidade

Compatibilidade da rota: o esquema unificado /v1/videos do CometAPI não necessariamente expõe todos os campos nas APIs nativas T2V, I2V, R2V e de edição de vídeo da Alibaba Cloud. Texto-para-vídeo e imagem-para-vídeo básicos são os pontos de partida mais seguros. Antes de lançar controle de primeiro/último quadro, múltiplas referências de entrada, condução por áudio ou edição de vídeo, verifique os campos exatos da rota live e os limites de mídia.

O que você precisa antes de começar

Crie uma conta CometAPI e uma chave de API

Crie ou acesse uma conta CometAPI e então gere uma chave de API. Armazene-a em uma variável de ambiente. Não codifique a chave em controle de versão, código de navegador ou aplicativos móveis.

export COMETAPI_KEY="your_api_key"$env:COMETAPI_KEY="your_api_key"

Conheça o ID do modelo e os endpoints

Model ID: wan2.7 Create endpoint: POST https://api.cometapi.com/v1/videos Status endpoint: GET https://api.cometapi.com/v1/videos/{video_id} Download endpoint: GET https://api.cometapi.com/v1/videos/{video_id}/content

Instale o pacote Python

python -m pip install --upgrade requests

Os exemplos usam requisições HTTP puras porque multipart form data, polling de status e downloads binários são mais fáceis de entender sem uma camada adicional de SDK.

Como usar a API do Wan 2.7 com CometAPI

Etapa 1: crie uma tarefa de texto-para-vídeo

Envie uma requisição multipart com o modelo, prompt, duração e tamanho. Este exemplo de 5 segundos em 720p é a forma de menor risco para validar credenciais, roteamento e criação de tarefa.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=A cinematic tracking shot of a futuristic train crossing a snowy mountain valley at sunrise, smooth camera motion, realistic light." \  -F "seconds=5" \  -F "size=1280x720"The response should include a task identifier under id or task_id. Log the full response during integration because providers and route versions may wrap status data differently.{  "id": "video_task_id",  "status": "queued",  "progress": 0 }

Etapa 2: consulte o status do vídeo

Use o ID retornado no endpoint de status. Consultar a cada 10-15 segundos geralmente é mais apropriado do que loops apertados para uma tarefa de vídeo intensiva em computação.

curl https://api.cometapi.com/v1/videos/{video_id} \  -H "Authorization: Bearer $COMETAPI_KEY"{  "id": "video_task_id",  "status": "in_progress",  "progress": 45 }

Sua aplicação deve tratar completed ou success como estados terminais bem-sucedidos e failed, error ou FAILURE como estados terminais com falha. Preserve todo o payload de falha para diagnóstico.

Etapa 3: baixe o MP4 concluído

Baixe somente depois que a tarefa atingir um estado terminal bem-sucedido. Salvar a resposta de uma tarefa incompleta pode criar um arquivo vazio ou um documento de erro com extensão MP4.

curl https://api.cometapi.com/v1/videos/{video_id}/content \  -H "Authorization: Bearer $COMETAPI_KEY" \  --output wan2_7_output.mp4

Etapa 4: gere vídeo a partir de uma imagem

Para imagem-para-vídeo, envie a referência como dados multipart e use um prompt que descreva o movimento, o comportamento da câmera e a mudança temporal pretendida. A rota unificada comumente usa input_reference. Confirme suas regras atuais de tamanho de arquivo, formato e contagem de imagens antes da produção.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=The camera slowly pushes forward while the subject turns toward the warm window light; preserve identity, clothing and background composition." \  -F "input_reference=@reference.png" \  -F "seconds=5" \  -F "size=1280x720"

Dica de prompt de imagem: Não gaste a maior parte do prompt redescrevendo conteúdo estático já visível na referência. Use o orçamento do prompt para movimento, direção de câmera, timing, mudanças e restrições.

Etapa 5: construa o fluxo de trabalho completo em Python

O programa a seguir valida a chave da API, envia uma tarefa, normaliza respostas embrulhadas de status, aplica uma espera máxima, trata falhas terminais e baixa o arquivo concluído.

import os import time from pathlib import Path​ import requests​ API_KEY = os.environ.get("COMETAPI_KEY") BASE_URL = "https://api.cometapi.com/v1" POLL_INTERVAL = 12 MAX_WAIT_SECONDS = 900​ if not API_KEY:    raise RuntimeError("Set COMETAPI_KEY before running this script.")​ headers = {"Authorization": f"Bearer {API_KEY}"}​ def parse_task_data(payload):    return payload.get("data") or payload​ # 1. Submit the generation task. submit = requests.post(    f"{BASE_URL}/videos",    headers=headers,    files={        "model": (None, "wan2.7"),        "prompt": (            None,            "A cinematic tracking shot of a futuristic train "            "crossing a snowy mountain valley at sunrise."        ),        "seconds": (None, "5"),        "size": (None, "1280x720"),    },    timeout=60, ) submit.raise_for_status() submit_payload = submit.json() video_id = submit_payload.get("id") or submit_payload.get("task_id")​ if not video_id:    raise RuntimeError(f"No video ID in response: {submit_payload}")​ print(f"Created video task: {video_id}")​ # 2. Poll until a terminal state or timeout. deadline = time.monotonic() + MAX_WAIT_SECONDS while time.monotonic() < deadline:    response = requests.get(        f"{BASE_URL}/videos/{video_id}",        headers=headers,        timeout=30,    )    response.raise_for_status()    payload = response.json()    data = parse_task_data(payload)    status = str(data.get("status", "unknown"))    progress = data.get("progress", "unknown")    print(f"status={status}, progress={progress}")​    if status in {"completed", "success"} or progress in {100, "100", "100%"}:        break    if status in {"failed", "error", "FAILURE"}:        raise RuntimeError(f"Video generation failed: {payload}")​    time.sleep(POLL_INTERVAL) else:    raise TimeoutError(f"Task {video_id} exceeded {MAX_WAIT_SECONDS}s")​ # 3. Download the completed MP4. video = requests.get(    f"{BASE_URL}/videos/{video_id}/content",    headers=headers,    timeout=180, ) video.raise_for_status()​ output = Path("output") / f"{video_id}.mp4" output.parent.mkdir(parents=True, exist_ok=True) output.write_bytes(video.content)​ if output.stat().st_size == 0:    raise RuntimeError("Downloaded file is empty.")​ print(f"Saved {output} ({output.stat().st_size} bytes)")

Etapa 6: chame o Wan 2.7 com JavaScript

Este exemplo em Node.js usa fetch e FormData nativos. Use Node.js 18 ou posterior; o exemplo grava o resultado com node:fs/promises.

import { mkdir, writeFile } from "node:fs/promises";​ const apiKey = process.env.COMETAPI_KEY; const baseUrl = "https://api.cometapi.com/v1"; const pollIntervalMs = 12_000; const maxWaitMs = 15 * 60 * 1000;​ if (!apiKey) throw new Error("Set COMETAPI_KEY first.");​ const headers = { Authorization: `Bearer ${apiKey}` }; const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));​ const form = new FormData(); form.append("model", "wan2.7"); form.append(  "prompt",  "A cinematic tracking shot of a futuristic train crossing " +    "a snowy mountain valley at sunrise." ); form.append("seconds", "5"); form.append("size", "1280x720");​ const submitResponse = await fetch(`${baseUrl}/videos`, {  method: "POST",  headers,  body: form, }); if (!submitResponse.ok) throw new Error(await submitResponse.text());​ const submitPayload = await submitResponse.json(); const videoId = submitPayload.id || submitPayload.task_id; if (!videoId) throw new Error(`No video ID: ${JSON.stringify(submitPayload)}`);​ const deadline = Date.now() + maxWaitMs; while (Date.now() < deadline) {  const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers });  if (!statusResponse.ok) throw new Error(await statusResponse.text());​  const payload = await statusResponse.json();  const data = payload.data || payload;  const status = String(data.status || "unknown");  const progress = data.progress ?? "unknown";  console.log({ status, progress });​  if (["completed", "success"].includes(status) || [100, "100", "100%"].includes(progress)) {    break;  }  if (["failed", "error", "FAILURE"].includes(status)) {    throw new Error(`Generation failed: ${JSON.stringify(payload)}`);  }  await sleep(pollIntervalMs); }​ if (Date.now() >= deadline) throw new Error(`Task ${videoId} timed out.`);​ const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers }); if (!videoResponse.ok) throw new Error(await videoResponse.text());​ await mkdir("output", { recursive: true }); const outputPath = `output/${videoId}.mp4`; await writeFile(outputPath, Buffer.from(await videoResponse.arrayBuffer())); console.log(`Saved ${outputPath}`);

Quais são os parâmetros da API do Wan 2.7?

ParâmetroTipoObrigatórioExemploFinalidade
modelstringSimwan2.7Seleciona a rota
promptstringSimDescrição de cenaDefine conteúdo, movimento e estilo
secondsintegerNão5Controla duração e custo
sizestringNão1280x720Controla resolução / proporção
input_referencefileI2Vreference.pngFornece uma imagem de origem
AuthorizationheaderSimBearer tokenAutentica a requisição

Mapeamento de parâmetros entre CometAPI e nativo Alibaba

ConceitoCometAPIAPI nativa da Alibaba
Modelowan2.7wan2.7-t2v ou wan2.7-i2v-*
Duraçãosecondsduration
Resoluçãosizeresolution mais ratio
Imagem de referênciainput_referencemedia[].type=first_frame
Identificador da tarefaid ou task_idoutput.task_id
Status da tarefaGET /v1/videos/{id}Endpoint de consulta de tarefa do provedor
Resultado binárioGET /v1/videos/{id}/contentURL temporária de resultado / resposta do provedor

Esse mapeamento explica por que exemplos copiados da Alibaba Cloud não podem ser colados sem alterações no CometAPI. A capacidade do modelo é relacionada, mas a camada de acesso e o esquema são diferentes.

Como escrever melhores prompts para o Wan 2.7: exemplos

Um prompt prático de vídeo define o que deve permanecer estável e o que deve mudar ao longo do tempo. Use esta estrutura:

Subject + action + environment + camera movement + lighting + visual style + timeline + audio direction + constraints

Prompt de tomada única

A red vintage roadster drives along a wet coastal highway at blue hour. The camera tracks low beside the front wheel, then rises smoothly to reveal ocean cliffs. Realistic reflections, restrained motion blur, cinematic 35mm look, no text or logos.

Prompt multishot

Create a cinematic detective sequence with consistent character identity. Shot 1 [0-2s]: a rain-soaked city street at night, neon reflected in puddles. Shot 2 [2-4s]: the detective enters an old building; slow handheld follow shot. Shot 3 [4-5s]: close-up of a clue under a narrow flashlight beam. Preserve the same coat, face and lighting palette across all shots. No captions.

Prompt de imagem-para-vídeo

Preserve the subject's face, clothing and background layout. The subject looks up, turns slightly toward the window and takes one step forward. Slow camera push-in, warm light gradually increases, natural hair and fabric motion, no new objects.

Orientação para prompt negativo

Use prompts negativos para suprimir modos recorrentes de falha, em vez de descrever a cena desejada uma segunda vez. Uma lista concisa como low resolution, deformed hands, duplicated limbs, flicker, unstable face, unreadable text e watermark costuma ser mais útil do que um longo parágrafo contraditório.

Quanto custa a API do Wan 2.7?

A rota atual do CometAPI lista o Wan 2.7 a $0.08 por segundo para 720p e $0.12 por segundo para 1080p. O custo estimado é, portanto, uma função direta da duração gerada e da resolução selecionada.

ResoluçãoPreço / segundo5 segundos10 segundos15 segundos
720p$0.08$0.40$0.80$1.20
1080p$0.12$0.60$1.20$1.80
Estimated video cost = price per second x generated duration in seconds

Fonte dos dados: CometAPI live model pricing.

Interpretação de preços: Não afirme que uma rota agregadora é mais barata do que a Alibaba Cloud sem comparar a mesma região, variante de modelo, resolução, duração, modo de áudio e unidade de cobrança. O preço claro por segundo do CometAPI e o faturamento unificado são vantagens de integração; uma vantagem de preço do provedor exige uma comparação em bases iguais.

Um clipe 1080p que falha na revisão criativa é mais caro do que seu preço de geração listado porque a equipe deve regenerá-lo. Para planejamento de produção, divida o gasto total pelo número de clipes aceitos sem retrabalho.

Wan 2.7 vs Seedance 2.5 vs Vidu Q3 vs Veo 3.1

As alternativas mais úteis na mesma plataforma são Seedance 2.5, Vidu Q3 e Veo 3.1. A tabela abaixo compara o ajuste ao fluxo de trabalho em vez de declarar um vencedor universal. Recursos de rota podem mudar, portanto verifique entradas avançadas antes da produção.

DimensãoWan 2.7Seedance 2.5Vidu Q3Veo 3.1
Posicionamento principalSuíte multimodal controlávelGeração mais longa e pesada em referênciasCriação rápida orientada à narrativaVídeo cinematográfico com áudio nativo
Texto-para-vídeoSimSimSimSim
Imagem-para-vídeoSimSimSimSim
Controle de primeiro/último quadroSuporte nativo da famíliaDependente da rotaSuportadoSuportado em fluxos selecionados
Continuação de vídeoSuporte nativo da famíliaOrientado à ediçãoDependente da rotaFluxos de extensão
ÁudioOrientação de entrada + BGM/SFX automáticosÁudio-vídeo conjuntoÁudio sincronizado nativoÁudio sincronizado nativo
Duração comum da rota2-15 s no T2V nativo4-30 s listado na rota1-16 s listado na rotaModos oficiais de 4/6/8 s
Resolução máxima comum1080pDependente da rota1080p1080p; outras variantes podem diferir
Melhor ajusteFluxos de produção controladosNarrativas mais longas com múltiplas referênciasIteração narrativa rápidaShots cinematográficos de alto nível

Resultados da comparação

  • Escolha o Wan 2.7 quando controle de primeiro/último quadro, continuação, orientação por áudio e um fluxo de trabalho controlável amplo forem mais importantes do que o comprimento máximo de um único clipe.
  • Escolha o Seedance 2.5 quando narrativa multishot mais longa e trabalho criativo pesado em referências forem prioridade.
  • Escolha o Vidu Q3 quando iteração rápida de narrativa, áudio sincronizado e fluxos orientados ao criador forem centrais.
  • Escolha o Veo 3.1 quando qualidade cinematográfica, realismo visual e áudio integrado justificarem um custo de rota mais alto.
  • Não escolha um vencedor apenas por especificações. Use um conjunto fixo de prompts e ativos, compare a taxa de saída aprovada e o custo total de produção.

Melhores práticas de produção

Ciclo de vida da tarefa e confiabilidade

  • Persista o ID da tarefa imediatamente após a criação.
  • Use uma estratégia de idempotência na sua aplicação para que uma nova tentativa do cliente não crie tarefas pagas duplicadas.
  • Faça polling com intervalo de 10-15 segundos e um tempo máximo em vez de loop sem limite.
  • Diferencie falhas HTTP transitórias de falhas de geração declaradas pelo provedor.
  • Use backoff exponencial para erros de rede ou limite de taxa, mas não tente novamente cegamente falhas de política de conteúdo.
  • Marque um job como concluído somente após o download da saída e validação de que não está vazia.
  • Não dependa permanentemente de uma URL temporária do provedor; copie as saídas aceitas para o seu próprio storage controlado onde permitido.

Qualidade e controle de custos

  • Prototipe prompts em 720p e duração curta antes de gerar masters em 1080p.
  • Mantenha juntos o prompt, prompt negativo, ID do modelo, rota, resolução, duração, ID da tarefa e hash da saída para reprodutibilidade.
  • Construa um rubrica de revisão para aderência ao prompt, movimento, consistência temporal, identidade, mãos, artefatos de texto, áudio e segurança.
  • Meça o custo por saída aceita, não apenas o custo por requisição.
  • Mantenha um pequeno conjunto de prompts de regressão e rode-o novamente antes de trocar versões de rota ou provedores de modelo.

Segurança e governança

  • Mantenha chaves de API no servidor e gire-as quando houver suspeita de exposição.
  • Valide uploads de imagem e vídeo antes de encaminhá-los para a rota de geração.
  • Aplique controles de consentimento, semelhança e propriedade intelectual para mídias de referência.
  • Adicione revisão humana para publicidade, notícias, política, medicina ou outros usos de alto impacto.
  • Retenha metadados de proveniência e aplique marca d’água ou políticas de divulgação exigidas pela sua jurisdição e plataforma.

Erros comuns e solução de problemas

Erro ou sintomaCausa provávelCorreção recomendada
401 UnauthorizedChave ausente, inválida ou revogadaVerifique o Bearer token e a variável de ambiente
400 Bad RequestCampo, tamanho ou duração não suportadosComece pelo exemplo da página do modelo e adicione campos aos poucos
Sem ID de tarefaWrapper inesperado de respostaRegistre a resposta completa e verifique data, id e task_id
Em fila por muito tempoCarga ou capacidade do provedorContinue o polling com limite; não duplique a tarefa
Falha na geraçãoErro de mídia, prompt, política ou do provedorInspecione o payload terminal antes de decidir se deve tentar novamente
MP4 vazioDownload antes da conclusão ou corpo de erro salvoVerifique status e Content-Type antes de gravar o arquivo
Referência rejeitadaFormato, dimensões, tamanho ou contagem de mídiaConverta para PNG/JPEG e siga os limites atuais da rota
Custo inesperadoDuração longa, alta resolução ou novas tentativasPrototipe em 720p e acompanhe a taxa de saída aceita
Resultado inconsistenteGeração estocástica ou prompt de movimento vagoEspecifique timing e restrições; compare vários candidatos

Recomendação final

O valor prático do Wan 2.7 está na amplitude de seu fluxo de trabalho de vídeo controlável: texto-para-vídeo, animação de imagens, quadros ancorados, continuação, geração guiada por referência e comportamento sensível a áudio. Através do CometAPI, o caminho mais rápido é validar uma solicitação de 5 segundos em 720p com o endpoint assíncrono unificado e, em seguida, adicionar entradas de imagem e saída em 1080p depois que criação de tarefa, polling e download estiverem confiáveis.

Para produção, mantenha recursos nativos avançados atrás de verificações explícitas de capacidade, pois o esquema unificado do CometAPI pode não expor todos os campos da Alibaba. Compare o Wan 2.7 com alternativas usando os mesmos prompts e ativos e selecione a rota que produz o menor custo por vídeo aprovado, e não o menor preço de manchete.

FAQs

O que é a API do Wan 2.7?

É uma família de geração de vídeo multimodal acessível por API, cobrindo texto-para-vídeo, imagem-para-vídeo, fluxos de trabalho guiados por referência e edição de vídeo. O CometAPI expõe a rota do cliente por meio do ID de modelo wan2.7.

Qual é o ID do modelo Wan 2.7 no CometAPI?

Use wan2.7. Não substitua por identificadores nativos da Alibaba como wan2.7-t2v a menos que você esteja chamando a Alibaba Cloud diretamente.

Qual endpoint cria um vídeo no Wan 2.7?

Envie uma requisição multipart POST para https://api.cometapi.com/v1/videos. Em seguida, consulte /v1/videos/{video_id} e baixe de /v1/videos/{video_id}/content.

O Wan 2.7 suporta texto-para-vídeo e imagem-para-vídeo?

Sim. Ambos são recursos listados. Imagem-para-vídeo adiciona uma imagem de referência e deve usar os requisitos atuais de campo multipart da rota.

Quais resoluções o Wan 2.7 suporta?

A rota de vídeo publicada do Wan 2.7 suporta 720p e 1080p. A documentação nativa de texto-para-vídeo também lista dimensões de saída específicas para cada proporção em ambos os níveis.

Qual pode ser a duração de um vídeo no Wan 2.7?

A API nativa de texto-para-vídeo do Wan 2.7 da Alibaba permite durações inteiras de 2 a 15 segundos com padrão de 5 segundos. Use os valores documentados para a rota específica do CometAPI que você chamar.

O Wan 2.7 gera áudio?

A Alibaba documenta geração guiada por áudio e música de fundo/efeitos sonoros automáticos quando o áudio é omitido. Os campos exatos de áudio expostos por uma rota unificada devem ser verificados antes da produção.

O Wan 2.7 pode usar primeiro e último quadros?

A família nativa de imagem-para-vídeo suporta fluxos de primeiro quadro e de primeiro+último quadro. Confirme os campos correspondentes na rota unificada antes de depender deles no CometAPI.

A API do Wan 2.7 é síncrona ou assíncrona?

É assíncrona. A criação da tarefa retorna um ID; sua aplicação deve consultar o status e baixar o resultado após a conclusão.

Quanto custa o Wan 2.7 no CometAPI?

A rota publicada lista $0.08 por segundo para 720p e $0.12 por segundo para 1080p. Um clipe de 5 segundos é, portanto, estimado em $0.40 ou $0.60, respectivamente.

Devo usar Wan 2.7, Seedance 2.5, Vidu Q3 ou Veo 3.1?

Use o Wan 2.7 para ampla controlabilidade, Seedance 2.5 para narrativa mais longa com muitas referências, Vidu Q3 para iteração rápida de narrativa e Veo 3.1 para saída cinematográfica premium. Valide a escolha com um teste A/B controlado.

O Wan 2.7 pode continuar um vídeo existente?

Sim, na família de modelos nativa por meio de um fluxo first_clip. A disponibilidade e o mapeamento de parâmetros na rota unificada do CometAPI devem ser verificados.

Continuar aprendendo

Conecte este artigo à próxima decisão.

Ver todos os tópicos
Publicado em Aug 31, 2026
Última atualização Sep 3, 2026
19 visualizações
Revisado para maior clareza, atribuição de fontes e terminologia de API atual.

Leia Mais