Alibaba
Wan 2.7 Video
wan2.7-video/text-to-video
Modelo de geração de vídeo da série WAN da Alibaba, com suporte a texto para vídeo, imagem para vídeo e vídeo guiado por referência; múltiplas entradas de referência mantêm a consistência de personagens e produtos entre tomadas
Experimentar wan2.7-video/text-to-video
Entrada
Criações
Ver todas as criaçõesSaída
videoPreços
wan2.7-video/text-to-video per second
| Especificações | Preço unitário |
|---|---|
| 720P | $0.100 |
| 1080P | $0.167 |
Visão geral do posicionamento
wan2.7-video/text-to-video é um modelo de texto para vídeo da série de vídeo WAN da Alibaba, acessível por meio da interface unificada do HiAPI.ai. Basta inserir um prompt de texto para gerar um clipe de vídeo com imagem e faixa de áudio opcional, com suporte a cinco proporções de tela (16:9, 9:16, 1:1, 4:3 e 3:4), duração ajustável entre 2 e 15 segundos, resolução de 720P ou 1080P, além de prompt negativo, semente aleatória e reescrita de prompt. Indicado para desenvolvedores que precisam gerar material de vídeo curto a partir de texto puro, em produção de conteúdo em lote e pré-visualização de storyboards criativos.
Destaques principais
- Controle programável dos parâmetros de texto para vídeo — duração, proporção de tela, resolução e semente são passados como parâmetros da interface, facilitando a geração em lote por script e a reprodução de resultados.
- Faixa de áudio opcional e reescrita de prompt — é possível informar uma URL de áudio wav/mp3 como faixa de áudio, e a reescrita de prompt vem ativada por padrão para complementar detalhes da imagem.
- Prompt negativo restringe a imagem — suporta até 500 caracteres de prompt negativo para excluir elementos indesejados e reduzir a taxa de resultados inúteis.
Descrição das capacidades
Geração de clipes de vídeo por parâmetros: gera vídeos a partir de um prompt combinado com duração (2–15 segundos), proporção de tela e nível de resolução; as especificações de saída são definidas no momento da requisição, reduzindo cortes e transcodificação posteriores.
Reescrita de prompt e restrição negativa: prompt_extend vem ativado por padrão e pode expandir descrições curtas; negative_prompt é passado separadamente para excluir conteúdos específicos da imagem, e os dois juntos aumentam o controle sobre o resultado.
Reprodução por semente e estabilidade do resultado: o parâmetro seed permite reproduzir ou ajustar finamente o resultado gerado com o mesmo prompt, facilitando a comparação de efeitos entre diferentes combinações de parâmetros.
Áudio anexo e remoção de marca d'água opcional: uma URL de áudio opcional pode ser usada como entrada de faixa de áudio gerada, e a chave watermark controla se a marca d'água de geração por IA é anexada, permitindo escolher o formato final conforme a necessidade.
Cenários de aplicação
- Equipes de conteúdo com produção em lote de materiais de vídeo curto — geração em lote de clipes de 2–15 segundos com prompts roteirizados, produzindo materiais verticais/horizontais prontos para veiculação ou reedição.
- Storyboard criativo e pré-visualização — uso do mesmo prompt com sementes diferentes para gerar rapidamente várias versões de imagem, produzindo materiais de pré-visualização dinâmica para comparação de propostas e confirmação do design de planos.
- Vídeos curtos para redes sociais com trilha sonora — prompt combinado com URL de áudio para gerar o vídeo final com faixa de áudio, produzindo conteúdo curto pronto para publicação em plataformas sociais.
Limitações e recomendações de escolha
A duração máxima por geração é de 15 segundos; vídeos longos exigem geração em segmentos e posterior montagem, e a coerência narrativa depende do processamento pós-produção. Atualmente só há suporte a texto para vídeo; caso seja necessário restringir a consistência da imagem com imagens ou materiais de referência, deve-se optar pela linha de imagem para vídeo da mesma série. A resolução máxima é 1080P, e cenários que exigem vídeos finais em alta resolução precisam avaliar soluções de upscaling posterior. O limite do prompt é de 5000 caracteres e o do prompt negativo é de 500 caracteres; roteiros muito longos precisam ser divididos em várias requisições.
Perguntas frequentes
Ver todas as perguntas →-
O Wan 2.7 Image to Video precisa de enviar uma imagem?
Sim. Atualmente, o wan2.7-video/image-to-video é um pipeline de imagem para vídeo; a imagem de entrada é responsável pelo sujeito e pela composição inicial, e o Prompt é responsável pelas ações, pelo movimento de câmara e pelas mudanças no ambiente.
-
Quais durações e resoluções o Wan 2.7 Image to Video suporta?
O contrato de requisição atual do HiAPI suporta 2–15s, com resoluções de saída de 720P e 1080P. Os valores disponíveis estão sujeitos ao painel de parâmetros da página e à documentação da API.
-
Como é cobrado o Wan 2.7 Image to Video?
As tarefas são cobradas com base na duração da saída e no nível selecionado. A página exibe o preço em tempo real seguindo a unidade monetária global, e a cobrança final é determinada pelo registro da tarefa bem-sucedida.
-
Como melhorar a estabilidade do sujeito na geração de vídeo a partir de imagem?
Use uma imagem de entrada com o sujeito nítido, poucas oclusões e composição completa; no Prompt, descreva primeiro a ação principal e o enquadramento da câmera, e depois liste a aparência, os materiais e as relações de fundo que devem ser preservados. Para o primeiro teste, recomenda-se usar uma duração mais curta.
Criar uma tarefa de geração
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO 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-KeystringOpcionalChave 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.
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órioValor fixo atual: wan2.7-video/text-to-video
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para wan2.7-video/text-to-video e a rota default — veja a tabela de parâmetros abaixo.
seedintegerOpcionalmin 0max 2147483647Semente aleatória, usada para reproduzir ou ajustar o resultado da geração; use um número inteiro; se não for informada, o sistema a gera aleatoriamente.
ratiostringOpcionalPadrão: "16:9"Proporção de largura e altura do vídeo, no formato de string de proporção; padrão 16:9.
16:99:161:14:33:4promptstringObrigatóriomaxLength 5000Prompt de texto para geração do vídeo, usado para descrever o conteúdo visual desejado.
durationintegerOpcionalPadrão: 5min 2max 15Duração do vídeo, em segundos; use um número inteiro; padrão 5.
audio_urlstringOpcionalURL de áudio opcional, com suporte aos formatos wav/mp3; a duração deve ser de 2 a 30 segundos e o tamanho do arquivo não pode exceder 15MB.
watermarkbooleanOpcionalPadrão: falseDefine se uma marca d'água de geração por IA será adicionada ao vídeo gerado; use um valor booleano; padrão false.
resolutionstringOpcionalPadrão: "1080P"Nível de resolução do vídeo; o valor afeta o preço cobrado por segundo; padrão 1080P.
720P1080Pprompt_extendbooleanOpcionalPadrão: trueDefine se o recurso de reescrita (expansão) de prompt será habilitado; use um valor booleano; padrão true.
negative_promptstringOpcionalPadrão: ""maxLength 500Prompt negativo, usado para excluir conteúdo visual indesejado; máximo de 500 caracteres; padrão string vazia.
callbackobjectOpcional
Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.
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órioObrigató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.
finalstoragestringOpcionalPadrã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.
temppersistentExemplos 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": "wan2.7-video/text-to-video",
"input": {
"ratio": "16:9",
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "1080P",
"prompt_extend": true,
"negative_prompt": ""
}
}' 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: "wan2.7-video/text-to-video",
input: {
"ratio": "16:9",
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "1080P",
"prompt_extend": true,
"negative_prompt": ""
}
}),
});
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": "wan2.7-video/text-to-video",
"input": {
"ratio": "16:9",
"prompt": "…",
"duration": 5,
"watermark": False,
"resolution": "1080P",
"prompt_extend": True,
"negative_prompt": ""
}
},
)
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
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome 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.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
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órioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos 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órioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescriçã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"
}
}
} Artigos
Ver todos os artigos →-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video na HiAPI: curl + Python
Faça uma requisição de imagem para vídeo funcional na HiAPI: do upload do primeiro quadro ao polling assíncrono e ao download final
-
Tutorial
Como usar kling-4.0/text-to-video através da API HiAPI: curl, Python e um exemplo de requisição executável
Guia prático para desenvolvedores: prompts cinematográficos, áudio sincronizado, polling assíncrono e download da saída
-
Tutorial
recraft-v4.1-flash geração de imagens por texto na prática: 5 cenários de negócio de alto valor e pontos de integração
Partindo de um custo de US$ 0,01 por imagem, planeje como aplicar a geração de imagens em negócios reais
-
Tutorial
Como chamar hailuo-2.3-fast/image-to-video pela API HiAPI: curl e Python na prática
A primeira requisição executável do nível rápido e econômico de geração de vídeo a partir de imagem — do ID do modelo ao download do MP4
-
Tutorial
Como chamar kling-4.0/image-to-video na HiAPI: curl, Python e polling
-
Avaliação comparativa
hailuo-2.3-fast/image-to-video comparação lado a lado: como escolher modelos de imagem para vídeo e pontos de migração
-
Tutorial
Usar Kandinsky 6.0 Pro text-to-video na HiAPI: tutorial de curl e Python
Demonstração prática com foco na requisição: montar a chamada de prompt para clipe de vídeo, enviar a requisição, consultar o status de conclusão e baixar o resultado
-
Avaliação comparativa
Comparação lado a lado do Recraft v4.1 Flash em text-to-image: guia de seleção e migração para desenvolvedores
Com um custo de $0.01 por imagem e capacidade de text-to-image pura, avalie se ele é adequado para seu pipeline de geração de imagens
-
Tutorial
Como chamar hailuo-2.3/text-to-video pela API HiAPI: curl, Python e exemplos de requisição executáveis
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Veo 3.1 Lite Google $0.060 /segundo -
Wan 3.0 Video Alibaba $0.040 /segundo -
Runway Gen 4.5 Runway $0.172 /segundo -
LTX 2.5 Fast Lightricks $0.086 /segundo -
HappyHorse 1.1 Alibaba $0.160 /segundo -
Gemini Omni Google -- -
Vidu Q3 Vidu $0.149 /segundo -
Ray 3.2 Luma $0.214 /vídeo -
PixVerse V6 PixVerse $0.036 /segundo -
Grok Imagine 1.5 Lite xAI $0.029 /segundo -
FLUX 3 Max Black Forest Labs $0.061 /segundo -
Wan 2.7 Video Alibaba $0.100 /segundo
Mesmo provedor
-
Wan 2.7 Video Alibaba $0.100 /segundo -
Wan 3.0 Video Alibaba $0.040 /segundo -
Qwen Image 3.0 Alibaba $0.036 /imagem -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres -
Z-Image Alibaba $0.008 /imagem -
Wan 2.6 Flash Alibaba $0.043 /segundo -
HappyHorse 1.1 Alibaba $0.160 /segundo -
Qwen Image 2.0 Alibaba $0.042 /imagem -
HappyHorse 1.0 Alibaba $0.168 /segundo -
Wan 2.7 Image Alibaba $0.035 /imagem -
Qwen Image 2.1 Alibaba $0.020 /imagem