Skip to main content
AnimateAnyone: Generate dance videos from images

AnimateAnyone video generation API reference

O modelo de geração de vídeo do AnimateAnyone cria vídeos a partir de um modelo de ação e uma imagem. Este tópico descreve como chamar a API de geração de vídeo.

Este documento aplica-se apenas à região China (Beijing). Para usar o modelo, é obrigatório utilizar uma chave de API da região China (Beijing).

Visão geral do modelo

Modelo

Descrição

animate-anyone-gen2

Gera vídeos de ações de personagens com base em imagens e modelos de ação.

Demonstração de desempenho

Imagem do personagemModelo de açãoSaída (com fundo de imagem)Saída (com fundo de vídeo)
05-9_16
04-9_16
  • Os exemplos anteriores foram gerados pelo Tongyi App, que integra o AnimateAnyone.
  • Crie modelos de ação usando a API de geração de modelo de ação do AnimateAnyone. Certifique-se de que o vídeo de source do modelo de ação esteja em conformidade com as leis e regulamentos aplicáveis. Você também deve possuir os direitos de uso do conteúdo do vídeo, incluindo o áudio.

HTTP

Pré-requisitos

Limitações de entrada

  • Formatos de imagem: JPG, PNG, JPEG ou BMP.
  • Requisitos da imagem: O arquivo deve ter menos de 5 MB, proporção igual ou inferior a 2 e lado mais longo de até 4.096 pixels.
  • Use URLs HTTP para o arquivo de imagem de entrada. Caminhos locais não são suportados. Para criar uma URL de um arquivo local, faça upload no espaço de armazenamento temporário.
  • Requisitos para diferentes tipos de geração de vídeo:

    Imagem de entrada

    Gerar com fundo de imagem

    (use_ref_img_bg é true)

    Gerar com fundo de vídeo

    (use_ref_img_bg é false)

    Retrato de corpo inteiro

    Suportado

    Suportado

    Retrato de meio corpo

    Suportado

    Não recomendado

    Ao gerar com fundo de vídeo, o personagem na imagem deve corresponder à posição do personagem no vídeo. Se você usar um retrato de meio corpo, o modelo gera aleatoriamente as partes ausentes, como pernas, o que introduz incerteza significativa. Portanto, esses cenários não são recomendados.

Etapa 1: Crie uma tarefa e obtenha um ID de tarefa 

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/
  • Esta chamada de API demanda tempo. Envie as tarefas de forma assíncrona.
  • Após o envio da tarefa, o sistema retorna um ID. Use esse ID para consultar o status e recuperar o resultado por meio da API de consulta de resultados.

Parâmetros da solicitação

CampoTipoLocalizaçãoObrigatórioDescriçãoExemplo
Content-TypeStringHeaderSimFormato do corpo da solicitação.application/json
AuthorizationStringHeaderSimSua chave de API com o prefixo Bearer.Bearer d1**2a
X-DashScope-AsyncStringHeaderSimDefina como enable para envio assíncrono de tarefas.enable
modelStringBodySimModelo a ser usado.animate-anyone-gen2
input.image_urlStringBodySimURL da imagem enviada. A imagem deve ser processada primeiro pela API de detecção de imagem do AnimateAnyone e recortada conforme necessário para o quadro de saída desejado.
  • O arquivo de imagem deve ter menos de 5 MB, proporção igual ou inferior a 2 e lado mais longo de até 4096 pixels.
  • Formatos suportados: JPG, PNG, JPEG e BMP.
O upload de arquivos suporta apenas links HTTP ou HTTPS. Caminhos de arquivos locais não são suportados.
http://aaa/bbb.jpg
input.template_idStringBodySimID do modelo de ação. Insira o template_id gerado pela API de geração de modelo de ação do AnimateAnyone.
O ID do modelo de ação passa por verificação de permissão. Certifique-se de que o template_id usado foi criado pela sua conta atual do Alibaba Cloud.
Sugestão: Aumente a resolução e a taxa de quadros do vídeo do modelo para melhorar a qualidade do vídeo gerado.
AACT.xxx.xxx-xxx.xxx
parameters.use_ref_img_bgBooleanBodyNãoControla o fundo do vídeo gerado.
  • true: O vídeo é gerado com o fundo da imagem de entrada.
  • false (padrão): O vídeo é gerado com o fundo do vídeo original do arquivo de modelo.
false
parameters.video_ratioStringBodyNãoAo gerar um vídeo com fundo de imagem, as proporções disponíveis são "9:16" ou "3:4". O padrão é "9:16".
Não tem efeito ao gerar com fundo de vídeo (use_ref_img_bg é false). O vídeo seguirá a proporção do modelo.
Certifique-se de que a proporção da imagem de entrada corresponda à proporção selecionada para evitar distorções.
"9:16"

Parâmetros da resposta

Campo

Tipo

Descrição

Exemplo

output.task_id

String

ID da tarefa assíncrona enviada. Use este ID para consultar o resultado da tarefa.

a8532587-fa8c-4ef8-82be-0c46b17950d1

output.task_status

String

Status da tarefa após o envio.

"PENDING"

request_id

String

Identificador único da solicitação.

7574ee8f-38a3-4b1e-9280-11c33ab46e51

Exemplo de solicitação 

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "animate-anyone-gen2",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251224/pkswoc/p883941.png",
        "template_id": "AACT.xxx.xxx-xxx.xxx"
    },
    "parameters": {
        "use_ref_img_bg": false,
        "video_ratio": "9:16"
    }
}'

Exemplo de resposta 

{
    "output": {
	"task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx"
}

Etapa 2: Consulte o resultado usando o ID da tarefa 

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

Parâmetros da solicitação

Campo

Tipo

Localização

Obrigatório

Descrição

Exemplo

Authorization

String

Header

Sim

Sua chave de API com o prefixo Bearer.

Bearer d1**2a

task_id

String

Url Path

Sim

ID da tarefa a ser consultada.

a8532587-fa8c-4ef8-82be-0c46b17950d1

Parâmetros da resposta

Campo

Tipo

Descrição

Exemplo

output.task_id

String

ID da tarefa consultada.

a8532587-fa8c-4ef8-82be-0c46b17950d1

output.task_status

String

Status da tarefa consultada.

Status da tarefa:

  • PENDING

  • PRE-PROCESSING

  • RUNNING

  • POST-PROCESSING

  • SUCCEEDED

  • FAILED

  • UNKNOWN: A tarefa não existe ou seu status é desconhecido.

output.video_url

String

URL do vídeo gerado. Válida por 24 horas após a conclusão da tarefa.

https://xxx/1.mp4"

usage.video_duration

Float

Duração do vídeo gerado, em segundos.

"video_duration": 10.23

usage.video_ratio

String

Tipo de proporção do vídeo gerado. Valor: standard.

"video_ratio": "standard"

request_id

String

Identificador único da solicitação.

7574ee8f-38a3-4b1e-9280-11c33ab46e51

Exemplo de solicitação 

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Exemplo de resposta 

{
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://xxx/1.mp4"
    },
    "usage": {
        "video_duration": 10.23,
        "video_ratio": "standard"
    }
}

Exemplo de resposta de erro 

{
    "request_id": "7574ee8f-38a3-4b1e-9280-xxxxxx",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "FAILED",
        "code": "xxx",
        "message": "xxxxxx"
    }
}

Códigos de erro

Para códigos de status comuns, consulte Códigos de erro.
Uso da API
Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
Multimodal em Tempo Real
API em tempo real
Incorporação de Texto
Mais Modelos
Toolkit/Framework
Produção de Modelos
File Management
Gerenciamento de modelos
Mais
AnimateAnyone video generation API reference - Alibaba Cloud Model Studio