Alibaba
Wan 2.7 Video
wan2.7-video/image-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/image-to-video
Entrada
Criações
Ver todas as criaçõesSaída
videoPreços
wan2.7-video/image-to-video per second
| Especificações | Preço unitário |
|---|---|
| 720P | $0.100 |
| 1080P | $0.167 |
Visão geral do posicionamento
wan2.7-video/image-to-video é um modelo de geração de vídeo orientado por imagem da série de vídeo Alibaba WAN, acessível por meio da interface unificada do HiAPI.ai. Ele gera vídeos a partir de uma imagem como ponto de partida e também aceita guias por imagem de referência/trecho de referência, permitindo controlar o conteúdo visual e o movimento de câmera por meio de prompts. A resolução de saída pode ser 720P ou 1080P, com duração de 2 a 15 segundos por geração, e suporta entrada combinada de primeiro quadro, último quadro, áudio condutor e trecho inicial. É indicado para desenvolvedores que precisam produzir vídeos curtos a partir de ativos de imagem existentes, para materiais publicitários, vitrines de e-commerce e pré-visualização de storyboard.
Destaques principais
- Geração orientada por imagem, com controle de primeiro e último quadros — é possível especificar simultaneamente a imagem do primeiro e do último quadro, restringindo a composição de início e fim do plano e reduzindo o custo de regeração causado por aleatoriedade.
- Trecho de referência e áudio condutor participam da geração — além dos quadros inicial e final, também é possível enviar um trecho inicial e áudio condutor, para que o resultado gerado se apoie no ritmo de movimento e na relação som-imagem.
- Duração e resolução ajustáveis conforme a necessidade — a duração de cada geração pode ser definida entre 2 e 15 segundos, e a resolução de saída pode ser 720P ou 1080P, adaptando-se a diferentes exigências de entrega.
Descrição das capacidades
Geração de imagem para vídeo: usa uma ou mais imagens como base visual, combinadas com um prompt de texto para gerar o vídeo; o prompt pode ter até 5000 caracteres, sendo adequado para converter ativos visuais existentes em conteúdo dinâmico.
Controle combinado de primeiro e último quadros: em uma única requisição é possível especificar ao mesmo tempo o primeiro e o último quadro, ou ainda incluir um trecho inicial como referência de partida, para delimitar as imagens de início e fim do plano.
Entrada de áudio condutor: suporta o envio de áudio condutor como entrada de mídia, fazendo com que o vídeo gerado corresponda em ritmo ao material sonoro fornecido e reduzindo a etapa de sincronização na pós-produção.
Expansão de prompt e prompt negativo: o prompt_extend permite ativar a expansão automática do prompt, o negative_prompt permite declarar elementos visuais a serem evitados, e o seed possibilita reproduzir o mesmo resultado.
Resolução e duração parametrizadas: a resolução e a duração de saída são parâmetros da requisição, permitindo alternar, na mesma interface, entre 720P/1080P e comprimentos de clipe de 2 a 15 segundos conforme o cenário.
Cenários de aplicação
- E-commerce e marcas: geração de vitrines dinâmicas a partir de imagens de produto — inserir a imagem principal do produto e os requisitos de exibição para produzir um vídeo curto dinâmico de alguns segundos, usado em páginas de detalhes, anúncios em feed e materiais para redes sociais.
- Equipes de conteúdo: conversão de imagens de personagem ou cenário em trechos de plano — usar a imagem de definição do personagem como primeiro quadro ou referência para gerar planos curtos compatíveis com a descrição do storyboard, aplicáveis a vídeos curtos, pré-visualização de animação e propostas criativas.
- Equipes de design: planos de transição com restrição de primeiro e último quadros — fornecer simultaneamente a imagem inicial e a final para gerar o trecho de transição entre ambas, usado em aberturas, transições e apresentação de soluções visuais.
- Fornecedores de material de áudio: geração visual orientada por áudio — enviar o material de áudio e a descrição visual para gerar trechos de vídeo compatíveis com o ritmo do som, usados em vídeos curtos musicais e conteúdos com narração.
Limitações e recomendações de seleção
O limite de duração por geração é de 15 segundos; narrativas mais longas exigem geração em segmentos e montagem na pós-produção, e a consistência entre trechos depende do controle por prompts e materiais de referência. As resoluções de saída são apenas 720P e 1080P; necessidades de qualidade superior devem ser avaliadas separadamente. As entradas de mídia são no máximo três, e cada tipo pode aparecer apenas uma vez. Se a tarefa for predominantemente criativa a partir de texto puro e não exigir base visual, considere os modelos de texto para vídeo da mesma série; para planos contínuos muito longos, este modelo não é a escolha adequada.
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/image-to-video
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para wan2.7-video/image-to-video e a rota default — veja a tabela de parâmetros abaixo.
seedintegerOpcionalmin 0max 2147483647Semente aleatória usada para controlar a aleatoriedade do resultado gerado; use um valor inteiro, pois a mesma semente, com os demais parâmetros iguais, permite reproduzir resultados semelhantes.
mediaarrayObrigatóriominItems 1maxItems 3
Array de entrada de mídia, que contém os diversos materiais necessários para a geração de vídeo a partir de imagem; os elementos são objetos com url e type, e os tipos suportados são first_frame, last_frame, driving_audio e first_clip, cada tipo podendo aparecer no máximo uma vez.
Array [ object ]
Itens do array
urlstringObrigatórioEndereço do material de mídia; use uma URL pública, uma URL OSS ou uma string base64 data URI suportada.
typestringObrigatórioTipo desse material de mídia, como string, usado para identificar seu papel no fluxo de geração (por exemplo, primeiro quadro, último quadro, áudio de condução, primeiro clipe).
first_framelast_framedriving_audiofirst_clippromptstringObrigatóriomaxLength 5000Prompt de texto para geração de vídeo a partir de imagem, descrevendo o conteúdo visual e os efeitos dinâmicos desejados.
durationintegerOpcionalPadrão: 5min 2max 15Duração do vídeo gerado, em segundos, como valor inteiro, padrão 5.
watermarkbooleanOpcionalPadrão: falseSe deve adicionar marca d'água ao vídeo gerado, como valor booleano, padrão false.
resolutionstringOpcionalPadrão: "1080P"Resolução do vídeo gerado, como string; a cobrança é por segundo e o preço unitário depende desse valor, padrão 1080P.
720P1080Pprompt_extendbooleanOpcionalPadrão: trueSe deve habilitar a expansão do prompt; quando ativada, o modelo expande automaticamente o prompt de entrada, como valor booleano, padrão true.
negative_promptstringOpcionalPadrão: ""maxLength 500Prompt negativo, usado para descrever conteúdo que não deve aparecer no vídeo gerado, 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/image-to-video",
"input": {
"media": "…",
"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/image-to-video",
input: {
"media": "…",
"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/image-to-video",
"input": {
"media": "…",
"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
Como chamar kling-4.0/image-to-video na HiAPI: curl, Python e polling
-
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
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
-
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
Como chamar hailuo-2.3/text-to-video pela API HiAPI: curl, Python e exemplos de requisição executáveis
-
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
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
-
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
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
LTX 2.5 Fast Lightricks $0.086 /segundo -
Kling 4.0 Kuaishou $0.330 /segundo -
HappyHorse 1.0 Alibaba $0.168 /segundo -
Seedance 2.5 ByteDance $0.121 /segundo -
Gemini Omni Google -- -
HappyHorse 1.1 Alibaba $0.160 /segundo -
Creatify Boreal Creatify $0.015 /segundo -
Ray 3.2 Luma $0.214 /vídeo -
Wan 3.0 Video Alibaba $0.040 /segundo -
Runway Gen 4.5 Runway $0.172 /segundo -
MiniMax H3 MiniMax $0.072 /segundo -
Veo 3.1 Lite Google $0.060 /segundo
Mesmo provedor
-
HappyHorse 1.1 Alibaba $0.160 /segundo -
Wan 2.7 Image Alibaba $0.035 /imagem -
Qwen Image 3.0 Alibaba $0.036 /imagem -
HappyHorse 1.0 Alibaba $0.168 /segundo -
Qwen Image 2.0 Alibaba $0.042 /imagem -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres -
Z-Image Alibaba $0.008 /imagem -
Qwen Image 2.1 Alibaba $0.020 /imagem -
Wan 2.6 Flash Alibaba $0.043 /segundo -
Wan 3.0 Video Alibaba $0.040 /segundo



