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ção | Wan 2.7 Video |
|---|---|
| Provedor | Alibaba / Wan |
| ID de modelo no CometAPI | wan2.7 |
| IDs nativos de texto-para-vídeo | wan2.7-t2v, wan2.7-t2v-2026-06-12 |
| ID nativo de imagem-para-vídeo | wan2.7-i2v-2026-04-25 |
| Entradas principais | Texto; imagem, áudio ou vídeo em fluxos de trabalho suportados |
| Saída principal | Vídeo gerado com comportamento de áudio suportado |
| Modos | T2V, I2V, R2V, edição de vídeo, primeiro/último quadro, continuação |
| Resolução | 720P e 1080P |
| Duração T2V | 2-15 segundos; padrão de 5 segundos |
| Proporções T2V | 16:9, 9:16, 1:1, 4:3, 3:4 |
| Limite de prompt | 5.000 caracteres para T2V nativo do Wan 2.7 |
| Limite de prompt negativo | 500 caracteres |
| Formatos e limites de áudio | WAV/MP3; 2-30 segundos; até 15 MB |
| Invocação | Assíncrona |
| Arquitetura / contagem de parâmetros | Nã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ência | Resultado público | Como interpretar |
|---|---|---|
| Design Arena vídeo-para-vídeo | Primeiro lugar; Elo 1335 em imagem publicada | Forte evidência de preferência em V2V |
| Especificações oficiais da API | 720P/1080P; 2-15 segundos para T2V | Flexibilidade de produção, não ranking de qualidade |
| Pontuação T2V padronizada | Não divulgada publicamente | Não reivindicar liderança T2V universal |
| Pontuação I2V padronizada | Não divulgada publicamente | Use um teste A/B interno |
| Benchmark de latência ou taxa de sucesso | Não padronizado publicamente | Meç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

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âmetro | Tipo | Obrigatório | Exemplo | Finalidade |
|---|---|---|---|---|
| model | string | Sim | wan2.7 | Seleciona a rota |
| prompt | string | Sim | Descrição de cena | Define conteúdo, movimento e estilo |
| seconds | integer | Não | 5 | Controla duração e custo |
| size | string | Não | 1280x720 | Controla resolução / proporção |
| input_reference | file | I2V | reference.png | Fornece uma imagem de origem |
| Authorization | header | Sim | Bearer token | Autentica a requisição |
Mapeamento de parâmetros entre CometAPI e nativo Alibaba
| Conceito | CometAPI | API nativa da Alibaba |
|---|---|---|
| Modelo | wan2.7 | wan2.7-t2v ou wan2.7-i2v-* |
| Duração | seconds | duration |
| Resolução | size | resolution mais ratio |
| Imagem de referência | input_reference | media[].type=first_frame |
| Identificador da tarefa | id ou task_id | output.task_id |
| Status da tarefa | GET /v1/videos/{id} | Endpoint de consulta de tarefa do provedor |
| Resultado binário | GET /v1/videos/{id}/content | URL 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ção | Preço / segundo | 5 segundos | 10 segundos | 15 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ão | Wan 2.7 | Seedance 2.5 | Vidu Q3 | Veo 3.1 |
|---|---|---|---|---|
| Posicionamento principal | Suíte multimodal controlável | Geração mais longa e pesada em referências | Criação rápida orientada à narrativa | Vídeo cinematográfico com áudio nativo |
| Texto-para-vídeo | Sim | Sim | Sim | Sim |
| Imagem-para-vídeo | Sim | Sim | Sim | Sim |
| Controle de primeiro/último quadro | Suporte nativo da família | Dependente da rota | Suportado | Suportado em fluxos selecionados |
| Continuação de vídeo | Suporte nativo da família | Orientado à edição | Dependente da rota | Fluxos de extensão |
| Áudio | Orientação de entrada + BGM/SFX automáticos | Áudio-vídeo conjunto | Áudio sincronizado nativo | Áudio sincronizado nativo |
| Duração comum da rota | 2-15 s no T2V nativo | 4-30 s listado na rota | 1-16 s listado na rota | Modos oficiais de 4/6/8 s |
| Resolução máxima comum | 1080p | Dependente da rota | 1080p | 1080p; outras variantes podem diferir |
| Melhor ajuste | Fluxos de produção controlados | Narrativas mais longas com múltiplas referências | Iteração narrativa rápida | Shots 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 sintoma | Causa provável | Correção recomendada |
|---|---|---|
| 401 Unauthorized | Chave ausente, inválida ou revogada | Verifique o Bearer token e a variável de ambiente |
| 400 Bad Request | Campo, tamanho ou duração não suportados | Comece pelo exemplo da página do modelo e adicione campos aos poucos |
| Sem ID de tarefa | Wrapper inesperado de resposta | Registre a resposta completa e verifique data, id e task_id |
| Em fila por muito tempo | Carga ou capacidade do provedor | Continue o polling com limite; não duplique a tarefa |
| Falha na geração | Erro de mídia, prompt, política ou do provedor | Inspecione o payload terminal antes de decidir se deve tentar novamente |
| MP4 vazio | Download antes da conclusão ou corpo de erro salvo | Verifique status e Content-Type antes de gravar o arquivo |
| Referência rejeitada | Formato, dimensões, tamanho ou contagem de mídia | Converta para PNG/JPEG e siga os limites atuais da rota |
| Custo inesperado | Duração longa, alta resolução ou novas tentativas | Prototipe em 720p e acompanhe a taxa de saída aceita |
| Resultado inconsistente | Geração estocástica ou prompt de movimento vago | Especifique 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.
