O modelo de edição de vídeo Wan 2.7 aceita entradas multimodais (texto, imagens e vídeos) para edição baseada em instruções e transferência de estilo .
Aplicabilidade
O modelo, a URL do endpoint e a API Key devem pertencer à mesma região. Chamadas entre regiões diferentes falham.
- Selecione um modelo: Confirme a região do modelo.
- Selecione uma URL de endpoint: Escolha a URL do endpoint correspondente à região. Há suporte tanto para URLs HTTP quanto do DashScope SDK.
- Configure uma API Key: Obtenha uma API Key para a região e configure it as an environment variable.
HTTP
As tarefas de edição de vídeo geralmente levam de 1 a 5 minutos. A API utiliza chamadas assíncronas com duas etapas principais: Criar uma tarefa -> Consultar o resultado.
Etapa 1: Criar uma tarefa
- Singapore
- Beijing
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} pelo seu workspace ID real.
- Após criar a tarefa, use o
task_idretornado para consultar o resultado. Otask_idé válido por 24 horas. Não crie tarefas duplicadas. Em vez disso, faça polling para recuperar o resultado. - Para orientações destinadas a iniciantes, consulte Call APIs with Postman or cURL.
Parâmetros da solicitação | |||||||||||||||||||||||||
Content-Type string (Obrigatório)Tipo de conteúdo da solicitação. Deve ser application/json. | |||||||||||||||||||||||||
Authorization string (Obrigatório)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |||||||||||||||||||||||||
X-DashScope-Async string (Obrigatório)Ativa o processamento assíncrono. Solicitações HTTP aceitam apenas chamadas assíncronas. Deve ser enable. | |||||||||||||||||||||||||
Corpo da solicitação | |||||||||||||||||||||||||
model string (Obrigatório)Nome do modelo.Valor de exemplo: wan2.7-videoedit. | |||||||||||||||||||||||||
input object (Obrigatório)Parâmetros de entrada, incluindo o prompt.
Propriedades prompt string (Opcional)Descreve os elementos desejados e as características visuais no vídeo gerado.Há suporte para chinês e inglês. Cada caractere chinês ou letra inglesa conta como um caractere. Textos mais longos são truncados automaticamente.
string (Opcional)Prompt negativo que descreve o conteúdo a excluir do vídeo, ajudando a refinar a saída.Há suporte para chinês e inglês. O comprimento não pode exceder 500 caracteres. Textos mais longos são truncados automaticamente.Valor de exemplo: baixa resolução, erro, melhor qualidade, baixa qualidade, desfigurado, dedos extras, proporções ruins.media array (Obrigatório)Lista de ativos de mídia, como imagens e vídeos, usados como referência para gerar o vídeo.Cada elemento no array é um objeto de mídia contendo os campos type e url.
Propriedades type string (Obrigatório)Tipo do ativo de mídia. Valores válidos:
string (Obrigatório)URL, dados codificados em Base64 ou asset_id do Asset Center do ativo de mídia. Os ativos incluem vídeos e imagens.
Vídeo de entrada (type=video) URL ou asset_id do Asset Center do arquivo de vídeo a editar.Requisitos de vídeo:
Imagem de entrada (type=reference_image) URL, dados codificados em Base64 ou asset_id do Asset Center da imagem de referência.Requisitos de imagem:
| |||||||||||||||||||||||||
parameters object (Opcional)Parâmetros para processamento de vídeo, como resolução, duração, reescrita inteligente de prompt e marca d'água.
Propriedades resolution string (Opcional)Categoria de resolução do vídeo gerado, que controla sua nitidez (total de pixels).
string (Opcional)Proporção do vídeo gerado.Comportamento:
integer (Opcional)Duração do vídeo gerado, em segundos.Recomendação: Defina este parâmetro apenas para truncar o vídeo. Para manter a mesma duração do vídeo de entrada, omita este parâmetro ou passe o valor padrão 0.Regras de uso:
string (Opcional)Configurações de som do vídeo.
boolean (Opcional)Ativa a reescrita inteligente de prompt. Quando ativado, um modelo grande reescreve o prompt de entrada, melhorando significativamente a qualidade da geração para prompts mais curtos, às custas de maior tempo de processamento.
boolean (Opcional)Indica se deve adicionar uma marca d'água. A marca d'água fica no canto inferior direito do vídeo com o texto "AI Generated".
integer (Opcional)A semente de número aleatório deve ser um inteiro no intervalo [0, 2147483647].Se não especificada, uma semente aleatória é gerada. Uma semente fixa melhora a reprodutibilidade.Como a geração do modelo é probabilística, a mesma semente não garante resultados idênticos. |
Parâmetros de resposta |
Salve o task_id para consultar o status e o resultado da tarefa. |
output objectContém a saída da tarefa.
Propriedades task_id stringID da tarefa. Válido para consultas por 24 horas.task_status stringStatus da tarefa.
Valores de enumeração
| |
request_id stringIdentificador único da solicitação para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Error codes. | |
message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Error codes. |
Etapa 2: Consultar o resultado
- Singapore
- Beijing
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} pelo seu workspace ID real.
- Recomendação de polling: A geração de vídeo leva vários minutos. Utilize um mecanismo de polling com intervalo razoável, como 15 segundos.
- Transição de estado da tarefa: PENDING → RUNNING → SUCCEEDED ou FAILED.
- Link do resultado: Após o sucesso da tarefa, uma URL de vídeo válida por 24 horas é retornada. Baixe e salve o vídeo em armazenamento permanente, como OSS.
- Validade do task_id: 24 horas. Após esse período, as consultas retornam o status da tarefa como
UNKNOWN.
Parâmetros da solicitação |
Substitua {task_id} pelo valor de task_id retornado pela chamada de API anterior. O task_id é válido para consultas por 24 horas, Substitua {WorkspaceId} pelo seu workspace ID real. |
Cabeçalhos | |
Authorization string (Obrigatório)Autentica a solicitação com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Parâmetros de caminho | |
task_id string (Obrigatório)ID da tarefa. |
Parâmetros de resposta |
As URLs de vídeo são válidas apenas por 24 horas e depois removidas automaticamente. Salve os vídeos gerados prontamente. |
outputobjectContém a saída da tarefa.
Propriedades task_id stringID da tarefa. Válido para consultas por 24 horas.task_status stringStatus da tarefa.
Valores de enumeração
stringHorário em que a tarefa foi enviada. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringHorário em que a tarefa foi executada. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.end_time stringHorário em que a tarefa foi concluída. O horário está em UTC+8 e o formato é YYYY-MM-DD HH:mm:ss.SSS.video_url stringURL do vídeo gerado. Retornada apenas quando task_status é SUCCEEDED.Válida por 24 horas. O vídeo está no formato MP4 com codificação H.264.orig_prompt stringPrompt de entrada original, correspondente ao parâmetro de solicitação prompt.code stringCódigo de erro. Retornado apenas para solicitações com falha. Consulte Error codes.message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Error codes. | |
usage objectEstatísticas de uso para faturamento. Cobrado apenas para tarefas bem-sucedidas.
Propriedades input_video_duration floatDuração do vídeo de entrada, em segundos.output_video_duration floatDuração do vídeo de saída, em segundos.duration floatDuração total do vídeo, usada para faturamento.Fórmula de faturamento: duration=input_video_duration+output_video_duration.SR integerCategoria de resolução do vídeo de saída. Valor de exemplo: 720.video_count integerNúmero de vídeos gerados. Este valor é fixo em 1. | |
request_id stringIdentificador único da solicitação para rastreamento e solução de problemas. |
DashScope SDK
Os nomes dos parâmetros no SDK são majoritariamente consistentes com a HTTP API, mas a estrutura dos parâmetros segue as convenções de cada linguagem.
A edição de vídeo geralmente leva de 1 a 5 minutos. O SDK lida internamente com o processo de chamada HTTP assíncrona, aceitando tanto chamadas síncronas quanto assíncronas.
O tempo real de processamento depende do número de tarefas na fila e do status do service. Aguarde a conclusão do resultado.
Python SDK
Defina o base_http_api_url com base na região do service:
- Singapore
- China (Beijing)
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'{WorkspaceId} pelo seu workspace ID real.
- Chamada síncrona
- Chamada assíncrona
Exemplo de solicitação
Exemplo de resposta
A video_url é válida por 24 horas. Baixe o vídeo prontamente.
Java SDK
Defina o Constants.baseHttpApiUrl com base na região do service:
- Singapore
- China (Beijing)
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";{WorkspaceId} pelo seu workspace ID real.
- Chamada síncrona
- Chamada assíncrona
Exemplo de solicitação
Exemplo de resposta
A video_url é válida por 24 horas. Baixe o vídeo prontamente.