O modelo de texto para vídeo Wan gera vídeos fluidos a partir de prompts de texto .
Referências: Guia do usuário
Para garantir chamadas bem-sucedidas, o modelo, a URL do Endpoint e a API Key devem pertencer à mesma região. Chamadas entre regiões falharão.
Como as tarefas de texto para vídeo demoram (geralmente de 1 a 5 minutos), a API utiliza invocação assíncrona. O processo envolve duas etapas principais: crie tarefa -> Consultar resultado. O fluxo é:
Os nomes dos parâmetros no SDK seguem majoritariamente a API http, com estrutura adaptada à linguagem de programação.
Como tarefas de texto para vídeo demoram (1 a 5 minutos), o SDK encapsula a chamada assíncrona http e suporta invocações síncronas e assíncronas.
defina dashscope.base_http_api_url conforme a região do modelo:
defina Constants.baseHttpApiUrl conforme a região do modelo:
Se a chamada falhar, consulte Códigos de erro para solução.
R: Não é possível converter diretamente. Seu backend deve recuperar a url, baixe o vídeo e carregá-lo em um armazenamento permanente, como o Alibaba Cloud object storage service (OSS), gerando novo link de acesso.
R: Não. O link expira em 24 horas. baixe e armazene o vídeo, usando depois um link permanente para reprodução.
Disponibilidade
Para garantir chamadas bem-sucedidas, o modelo, a URL do Endpoint e a API Key devem pertencer à mesma região. Chamadas entre regiões falharão.
- Selecione um modelo: Confirme a região do modelo.
- Selecione uma url: Escolha a url do Endpoint regional correspondente. urls http e do DashScope SDK são suportadas.
- configure uma API key: Selecione uma região, obtenha uma API key e configure-a como variável de ambiente (recurso a ser descontinuado e mesclado à configuração da API key).
- Instale o SDK: Para fazer chamadas com o SDK, instale o DashScope SDK.
O código de exemplo neste tópico aplica-se à região de Singapura.
http
Como as tarefas de texto para vídeo demoram (geralmente de 1 a 5 minutos), a API utiliza invocação assíncrona. O processo envolve duas etapas principais: crie tarefa -> Consultar resultado. O fluxo é:
Etapa 1: crie tarefa e obter o ID da tarefa
- Pequim
- Singapura
- Virgínia
- Frankfurt
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis- Singapura
- Virgínia
- Frankfurt
- Pequim
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_idvale por 24 horas. Não crie tarefas duplicadas. Use polling para recuperar o resultado. - Para orientações a iniciantes, consulte Chamar APIs com Postman ou cURL.
Parâmetros da solicitação |
|
Cabeçalhos 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 API key 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. defina como enable. | |
Corpo da solicitação | |
model string (Obrigatório)Nome do modelo. Consulte a lista de modelos disponíveis.Exemplo: wan2.6-t2v. | |
input object (Obrigatório)Contém informações básicas de entrada, como o prompt.
Propriedades prompt string (Obrigatório)Prompt de texto que descreve os elementos e características visuais desejados para o vídeo.Aceita chinês ou inglês. O comprimento é medido em caracteres (cada ideograma ou letra conta como um). Textos acima do limite são truncados automaticamente. O limite varia conforme o modelo:
string (Opcional)Descreve conteúdos a excluir do vídeo, ajudando a refinar a geração.Aceita chinês ou inglês. Máximo de 500 caracteres. Textos acima desse limite são truncados automaticamente.Exemplo: baixa resolução, erro, melhor qualidade, baixa qualidade, deformado, dedos extras, proporções ruins.audio_url string (Opcional)Modelos suportados: séries wan2.6 e wan2.5.url do arquivo de áudio usado pelo modelo para gerar o vídeo.Formatos de entrada suportados:
| |
parameters object (Opcional)Parâmetros de processamento de vídeo, como resolução, reescrita de prompt e marca d'água.
Propriedades size string (Opcional)Define a resolução do vídeo no formato largura*altura. Valores padrão e válidos dependem do parâmetro model:
integer (Opcional)Duração do vídeo em segundos. Valores válidos dependem do parâmetro model:
boolean (Opcional)ative a reescrita inteligente do prompt. Melhora significativamente a qualidade em prompts curtos, mas aumenta o tempo de execução.
string (Opcional)Modelos suportados: wan2.6.Define se o vídeo terá uma tomada contínua ou múltiplas tomadas variadas.Valores válidos:
"prompt_extend": true.Prioridade: shot_type > prompt. Se definido como "single", o modelo gera tomada única mesmo que o prompt peça múltiplas tomadas.watermark boolean (Opcional)Adiciona marca d'água fixa "AI Generated" no canto inferior direito do vídeo.
integer (Opcional)Semente aleatória (inteiro no intervalo [0, 2147483647]).Se omitida, gera-se uma semente aleatória. Sementes fixas melhoram a reprodutibilidade.Devido à natureza probabilística do modelo, a mesma semente não garante resultados idênticos. |
Parâmetros da resposta |
Salve o task_id para consultar status e resultado. |
output objectInformações de 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 troubleshooting. | |
code stringCódigo de erro. Retornado apenas em falhas. Consulte Códigos de erro. | |
message stringMensagem de erro detalhada. Retornada apenas em falhas. Consulte Códigos de erro. |
Etapa 2: Consultar resultado pelo ID da tarefa
- Pequim
- Singapura
- Virgínia
- Frankfurt
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}- Singapura
- Virgínia
- Frankfurt
- Pequim
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 leva vários minutos. Use polling com intervalo razoável (ex.: 15 segundos).
- Transição de estado: PENDING → RUNNING → SUCCEEDED ou FAILED.
- Link do resultado: Em caso de sucesso, retorna url válida por 24 horas. baixe e salve o vídeo em armazenamento permanente, como o OSS.
- Validade do task_id: 24 horas. Após esse período, consultas retornam status
UNKNOWN.
Parâmetros da solicitação |
Substitua {task_id} pelo task_id retornado anteriormente. Válido para consultas por 24 horas. |
Cabeçalhos da solicitação | |
Authorization string (Obrigatório)Autentica a solicitação com uma API key do Model Studio. Exemplo: Bearer sk-xxxx. | |
Parâmetros de caminho da url | |
task_id string (Obrigatório)ID da tarefa. |
Parâmetros da resposta |
urls de vídeo valem por 24 horas e são removidas automaticamente após esse prazo. Salve os vídeos prontamente. |
outputobjectInformações de 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 de envio da tarefa. Em UTC+8, no formato AAAA-MM-DD HH:mm:ss.SSS.scheduled_time stringHorário de execução da tarefa. Em UTC+8, no formato AAAA-MM-DD HH:mm:ss.SSS.end_time stringHorário de conclusão da tarefa. Em UTC+8, no formato AAAA-MM-DD HH:mm:ss.SSS.video_url stringurl do vídeo gerado. Retornada apenas quando task_status é SUCCEEDED.Válida por 24 horas. Formato MP4, codificação H.264.orig_prompt stringPrompt original enviado, correspondente ao parâmetro prompt.actual_prompt stringSe prompt_extend=true, contém o prompt reescrito usado na geração.
stringCódigo de erro. Retornado apenas em falhas. Consulte Códigos de erro.message stringMensagem de erro detalhada. Retornada apenas em falhas. Consulte Códigos de erro. | |
usage objectEstatísticas de saída. Disponível apenas em tarefas bem-sucedidas.
Propriedades video_duration integerRetornado apenas em modelos wan2.5 e anteriores. Usado para faturamento.Duração do vídeo em segundos. Valores válidos: 5 e 10.duration floatRetornado apenas no modelo wan2.6. Usado para faturamento.Duração total: duration = input_video_duration + output_video_duration.input_video_duration integerRetornado apenas no modelo wan2.6. Fixo em 0.output_video_duration integerRetornado apenas no modelo wan2.6.Duração do vídeo de saída em segundos. Igual a input.duration.SR integerRetornado apenas no modelo wan2.6. Categoria de resolução do vídeo. Exemplo: 720.size stringRetornado apenas no modelo wan2.6. Resolução no formato "larguraaltura". Exemplo: 19201080.video_ratio stringRetornado apenas em modelos wan2.5 e anteriores. Resolução no formato "larguraaltura". Exemplo: 832480.video_count integerQuantidade de vídeos gerados. Fixo em 1. | |
request_id stringIdentificador único da solicitação para rastreamento e troubleshooting. |
DashScope SDK
Os nomes dos parâmetros no SDK seguem majoritariamente a API http, com estrutura adaptada à linguagem de programação.
Como tarefas de texto para vídeo demoram (1 a 5 minutos), o SDK encapsula a chamada assíncrona http e suporta invocações síncronas e assíncronas.
O tempo real depende da fila e do status do serviço. Aguarde o resultado.
Python
defina dashscope.base_http_api_url conforme a região do modelo:
- Pequim
- Singapura
- Virgínia
- Frankfurt
dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'- Singapura
- Virgínia
- Pequim
- Frankfurt
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'Substitua WorkspaceId pelo seu ID do Workspace real.- Invocação síncrona
- Invocação assíncrona
Exemplo de solicitação
Exemplo de resposta
A video_url vale por 24 horas. baixe prontamente.
Java
defina Constants.baseHttpApiUrl conforme a região do modelo:
- Pequim
- Singapura
- Virgínia
- Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";- Singapura
- Virgínia
- Pequim
- Frankfurt
Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";Substitua WorkspaceId pelo seu ID do Workspace real.- Invocação síncrona
- Invocação assíncrona
Exemplo de solicitação
Exemplo de resposta
A video_url vale por 24 horas. baixe prontamente.
Códigos de erro
Se a chamada falhar, consulte Códigos de erro para solução.
FAQ
P: Como converter link temporário em permanente?
R: Não é possível converter diretamente. Seu backend deve recuperar a url, baixe o vídeo e carregá-lo em um armazenamento permanente, como o Alibaba Cloud object storage service (OSS), gerando novo link de acesso.
Exemplo: baixe vídeo localmente
Exemplo: baixe vídeo localmente