Wan2.7
Geração de Vídeo Wan2.7
- Modelo de geração de vídeo Wanxiang 2.7 do Alibaba Cloud (entrada unificada)
- Roteado automaticamente com base nos parâmetros: Text-to-Video / Image-to-Video (primeiro quadro, primeiro e último quadro, continuação de vídeo)
- Suporta resolução 720P/1080P, duração de 2 a 15 segundos
- Suporta áudio personalizado (música de fundo no modo text-to-video, áudio condutor no modo image-to-video)
POST
Autorização
string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione ao cabeçalho da requisição:
Roteamento de modos
wan2.7 é uma entrada unificada para text-to-video e image-to-video. O backend determina automaticamente o modo com base nos parâmetros recebidos. Ambos os modos são cobrados de forma idêntica:
Parâmetros da requisição
string
obrigatório
Nome do modelo de geração de vídeo, fixo como
wan2.7boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
true: verificar prompts e imagens de entrada comomni-moderation-latestfalseou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
Descrição do conteúdo do vídeo, até 5000 caracteres
- Modo Text-to-Video (quando nenhuma imagem/vídeo é fornecido): obrigatório
- Modo Image-to-Video: opcional, mas recomendado para guiar o movimento da câmera e as ações
"A cat chasing butterflies on the grass, bright sunshine, slow motion"array<string>
Array de URLs de imagens. Fornecê-lo entra automaticamente no modo Image-to-Video
- 1 imagem: primeiro quadro para o vídeo
- 2 imagens: primeiro e último quadro para o vídeo (1ª = primeiro quadro, 2ª = último quadro)
image_with_rolesarray<object>
Array de imagens com papéis, alternativa a
image_urls, usado para especificar com precisão o papel de cada imagemCampos de cada objeto:url(string): URL da imagem (suporta http/https)role(string): papel da imagem,first_frame/last_frame, padrãofirst_frame
array<string>
Array de URLs de vídeos. Fornecê-lo entra no modo de continuação de vídeo (apenas o 1º vídeo é usado)
Restrições do vídeo:
- Formato: mp4, mov
- Duração: 2–10s
- Resolução: largura e altura no intervalo [240, 4096] pixels
- Proporção: 1:8 – 8:1
- Tamanho do arquivo: até 100MB
string
Prompt negativo que descreve conteúdo indesejado, até 500 caracteresExemplo:
"blurry, distorted, low quality"string
padrão:"1080P"
Resolução do vídeoOpções:
720P- Padrão1080P- Alta definição (padrão)
integer
padrão:"5"
Duração do vídeo (segundos)Intervalo suportado:
2 ~ 15 segundosPadrão: 5string
padrão:"16:9"
Proporção de tela, efetivo apenas no modo Text-to-Video (quando nenhuma imagem/vídeo é fornecido)Formatos suportados:
16:9- Paisagem widescreen (padrão)9:16- Retrato1:1- Quadrado4:3- Paisagem3:4- Retrato
string
URL de áudio personalizado
- Modo Text-to-Video: usado como música de fundo
- Modo Image-to-Video: usado como áudio condutor, sincronizado com as ações na tela
boolean
padrão:"true"
Se deve ativar a reescrita inteligente do promptMelhora significativamente os resultados para prompts curtos, mas aumenta o tempo de processamentoPadrão:
trueboolean
padrão:"false"
Se deve adicionar a marca d’água “AI Generated” ao vídeo gerado
true: adicionar marca d’águafalse: sem marca d’água (padrão)
integer
Inteiro de seed usado para controlar a aleatoriedade do conteúdo geradoIntervalo de valores: inteiro
≥0- Para requisições idênticas, o modelo gera resultados diferentes ao receber valores de seed diferentes (por exemplo, omitindo o seed)
- Para requisições idênticas, o modelo gera resultados semelhantes ao receber o mesmo valor de seed, mas a consistência exata não é garantida
Resposta
integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados da resposta
Casos de uso
Caso 1: Texto para vídeo (Requisição mais simples)
Caso 2: Texto para vídeo (Parâmetros completos)
Caso 3: Primeiro quadro para vídeo
Caso 4: Primeiro e último quadro para vídeo
Com 2 imagens: a 1ª é o primeiro quadro, a 2ª é o último quadro. Você também pode usar image_with_roles para uma especificação precisa.
Caso 5: Continuação de vídeo
Caso 6: Imagem + áudio condutor
Guia de seleção de modo
Consultar resultados da tarefaA geração de vídeos é uma tarefa assíncrona que retorna um
task_id no envio. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.