O modelo de referência para vídeo do Wan aceita entrada multimodal e gera vídeos de interação com um ou vários personagens, usando pessoas ou objetos como protagonistas.
Veja também: Guia do usuário
O modelo, a URL do endpoint e a chave de API devem pertencer à mesma região. Chamadas entre regiões diferentes falharão.
As tarefas de geração de vídeo geralmente levam de 1 a 5 minutos. A API usa chamadas assíncronas em duas etapas: "crie uma tarefa -> consulte o resultado". Veja os detalhes a seguir:
Os parâmetros do SDK seguem as mesmas convenções de nomenclatura da API HTTP, com wrappers específicos para cada linguagem.
As tarefas de referência para vídeo geralmente levam de 1 a 5 minutos. O SDK encapsula o fluxo de trabalho assíncrono HTTP e suporta chamadas síncronas e assíncronas.
Defina base_http_api_url com base na região do modelo:
Defina baseHttpApiUrl com base na região do modelo:
Se a chamada do modelo falhar e retornar uma mensagem de erro, consulte Códigos de erro para resolução.
Disponibilidade
O modelo, a URL do endpoint e a chave de API devem pertencer à mesma região. Chamadas entre regiões diferentes falharão.
- Selecione um modelo: Confirme a região do modelo.
- Selecione uma URL: Use a URL do endpoint correspondente à região. URLs HTTP são suportadas.
- Configure a chave de API: Selecione uma região e Obtenha uma chave de API. Em seguida, Configure a chave de API como variável de ambiente.
Os códigos de exemplo neste tópico aplicam-se à região de Singapura.
HTTP
As tarefas de geração de vídeo geralmente levam de 1 a 5 minutos. A API usa chamadas assíncronas em duas etapas: "crie uma tarefa -> consulte o resultado". Veja os detalhes a seguir:
Etapa 1: Crie uma tarefa
- China (Beijing)
- Singapore
- US (Virginia)
- Frankfurt
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis- Singapore
- US (Virginia)
- Frankfurt
- China (Beijing)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesisSubstitua WorkspaceId pelo seu ID do Workspace 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, use polling para recuperar o resultado. - Para orientações destinadas a iniciantes, consulte Chamar APIs com Postman ou cURL.
Parâmetros da solicitação |
Informe as URLs de imagens e vídeos em reference_urls. Defina shot_type como multi para vídeo com múltiplas tomadas. |
Headers | |
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)Ative o processamento assíncrono. Solicitações HTTP suportam apenas chamadas assíncronas. Deve ser enable. | |
Corpo da solicitação | |
model string (Obrigatório)Modelo a ser usado. Consulte Preços dos modelos para ver os modelos disponíveis e seus preços.Exemplo: wan2.6-r2v-flash. | |
input object (Obrigatório)Parâmetros de entrada, como o prompt.
Propriedades prompt string (Obrigatório)Prompt de texto descrevendo os elementos desejados e as características visuais do vídeo gerado.Suporta chinês e inglês. Cada caractere conta como um. O conteúdo excedente será truncado automaticamente.
string (Opcional)Prompt negativo descrevendo elementos indesejados no vídeo.Suporta chinês e inglês. Comprimento máximo: 500 caracteres. O conteúdo excedente será truncado automaticamente.Exemplo: low resolution, errors, worst quality, low quality, incomplete, extra fingers, poor proportions, etc.reference_urls array[string] (Obrigatório)Array de URLs de arquivos de referência. Suporta entradas de vídeo e imagem. Usado para extrair a aparência e a voz do personagem (se disponível) e gerar vídeos correspondentes às características da referência.
Descontinuado reference_video_urls array[string]Array de URLs de vídeos de referência. Usado para extrair a aparência e a voz do personagem (se disponível) e gerar vídeos correspondentes às características da referência.
| |
parameters object (Opcional)Parâmetros de geração de vídeo, como resolução, reescrita de prompt e marca d'água.
Propriedades size string (Opcional)Resolução do vídeo gerado, no formato largura*altura. O valor padrão e as opções disponíveis dependem do parâmetro model:
integer (Opcional)Duração do vídeo gerado, em segundos.
string (Opcional)Composição das tomadas do vídeo gerado, determinando se o vídeo consiste em uma única tomada contínua ou múltiplas tomadas.Prioridade do parâmetro: shot_type > prompt. Por exemplo, se shot_type for definido como "single", o modelo produzirá um vídeo de tomada única mesmo que o prompt diga "gerar um vídeo de múltiplas tomadas".Valores válidos:
Use este parâmetro para controlar a estrutura narrativa do vídeo, como tomada única para vitrines de produtos ou múltiplas tomadas para clipes de histórias. boolean (Opcional)Modelo suportado: wan2.6-r2v-flash.Indica se deve gerar áudio no vídeo.Valores válidos:
boolean (Opcional)Indica se deve adicionar uma marca d'água. A marca d'água aparece no canto inferior direito 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 da resposta |
Salve o task_id para consultar o status e o resultado da tarefa. |
output objectSaí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 Códigos de erro. | |
message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Códigos de erro. |
Etapa 2: Recuperar o resultado da tarefa
- China (Beijing)
- Singapore
- US (Virginia)
- Frankfurt
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}- Singapore
- US (Virginia)
- Frankfurt
- China (Beijing)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}Substitua WorkspaceId pelo seu ID do Workspace real.- Recomendação de polling: A geração de vídeo leva vários minutos. Use 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 o 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. |
Headers | |
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 da resposta |
As URLs de vídeo são válidas apenas por 24 horas e depois são removidas automaticamente. Salve os vídeos gerados prontamente. |
outputobjectSaída da tarefa.
Propriedades task_id string (Obrigatório)ID da tarefa.task_status stringStatus da tarefa.
Valores de enumeração
stringMomento 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 stringMomento 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 stringMomento 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 Códigos de erro.message stringMensagem de erro detalhada. Retornada apenas para solicitações com falha. Consulte Códigos de erro. | |
usage objectEstatísticas de uso. Conta apenas resultados bem-sucedidos.
Propriedades input_video_duration integerDuração do vídeo de referência de entrada, em segundos.output_video_duration integerDuração do vídeo de saída, em segundos.duration floatDuração total do vídeo. O faturamento baseia-se neste valor.Fórmula: duration = input_video_duration + output_video_duration.SR integerNível de resolução do vídeo gerado. Exemplo: 720.size stringResolução do vídeo gerado no formato largura altura. Exemplo: 1280720.video_count integerNúmero de vídeos gerados. Sempre 1. | |
request_id stringIdentificador único da solicitação para rastreamento e solução de problemas. |
DashScope SDK
Os parâmetros do SDK seguem as mesmas convenções de nomenclatura da API HTTP, com wrappers específicos para cada linguagem.
As tarefas de referência para vídeo geralmente levam de 1 a 5 minutos. O SDK encapsula o fluxo de trabalho assíncrono HTTP e suporta chamadas síncronas e assíncronas.
O tempo real de processamento depende da fila de tarefas e da carga do servidor.
Python
Defina base_http_api_url com base na região do modelo:
- China (Beijing)
- Singapore
- Frankfurt
dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'- Singapore
- China (Beijing)
- Frankfurt
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'Substitua WorkspaceId pelo seu ID do Workspace real.- Synchronous
- Asynchronous
Chamadas síncronas bloqueiam a execução até que a geração do vídeo seja concluída e o resultado retornado.
Exemplo de solicitação
Java
Defina baseHttpApiUrl com base na região do modelo:
- China (Beijing)
- Singapore
- Frankfurt
Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";- Singapore
- China (Beijing)
- Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";Substitua WorkspaceId pelo seu ID do Workspace real.- Synchronous
- Asynchronous
Chamadas síncronas bloqueiam a execução até que a geração do vídeo seja concluída e o resultado retornado.