Skip to main content
AnimateAnyone: Generate dance videos from images

Referência da API de geração de modelos de ação do AnimateAnyone

Este modelo extrai movimentos de personagens em vídeos para gerar modelos de ação do AnimateAnyone. Este tópico descreve a API de geração de modelos.

Este documento aplica-se apenas à região China (Beijing). Para usar o modelo, você precisa de uma chave de API da região China (Beijing).

Visão geral do modelo

Modelo

Descrição

animate-anyone-template-gen2

Extrai movimentos de personagens de um vídeo para gerar um modelo de ação.

Exemplos

Exemplos corretos

Exemplos de vídeos que atendem aos requisitos para criação de modelos de ação
  • A pessoa deve estar totalmente visível, com o rosto nítido e sem partes do corpo obscurecidas.
  • A pessoa deve aparecer desde o primeiro quadro. A ação precisa ser contínua (tomada única). Divida vídeos com mudanças de cena em clipes separados.
  • Para obter melhores resultados, a pessoa deve estar voltada para a câmera no primeiro quadro. Evite curvaturas excessivas, agachamentos ou posições encolhidas.

Exemplos incorretos

Posturas curvadas e auto-oclusão

Várias pessoas no quadro

Pessoa desfocada

Pessoa muito pequena

(Rosto pouco nítido)

Pessoa muito grande

(Pessoa não totalmente visível)

Body occlusion

Multiple people

f3e2df6643d44db7a7d65d4571609bff_3 (1)

Person too small

Person too large

  • Verifique se nenhum quadro contém os erros mencionados anteriormente para garantir a qualidade do modelo.
  • Se o primeiro quadro apresentar qualquer um dos erros listados, a tarefa poderá falhar.
  • Certifique-se de que o arquivo de vídeo enviado esteja em conformidade com as leis e regulamentações aplicáveis.
  • Os modelos gerados preservam o áudio do vídeo enviado. Caso não deseje esse áudio ou não possua licença para ele (por exemplo, música de fundo), remova-o antes do envio.

HTTP

Descrição do recurso

Gera modelos de ação de personagens para uso com a API de geração de vídeo do AnimateAnyone na criação de vídeos de personagens.

Pré-requisitos

Limites de entrada

  • Formato de vídeo: MP4, AVI ou MOV.
  • O tamanho do arquivo de vídeo não pode exceder 200 MB.
  • As dimensões do vídeo devem variar de 200 a 2.048 pixels por lado. A taxa de quadros deve ser de pelo menos 24 fps. A codificação deve ser H.264 ou H.265.
  • A duração do vídeo deve variar de 2 a 60 segundos.
  • A proporção do vídeo deve estar entre 1:3 e 3:1.
  • Somente URLs HTTP são suportadas. Caminhos de arquivos locais não são aceitos.

Etapa 1: Crie uma tarefa e obtenha o ID da tarefa 

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/
  • Esta chamada de API demanda tempo e é executada de forma assíncrona.
  • Após o envio, o sistema retorna um ID de tarefa para consulta de status e resultados.

Parâmetros da solicitação

Campo

Tipo

Localização

Obrigatório

Descrição

Exemplo

Content-Type

String

Header

Sim

Formato do corpo da solicitação.

application/json

Authorization

String

Header

Sim

Sua chave de API com o prefixo Bearer.

Bearer d1**2a

X-DashScope-Async

String

Header

Sim

Defina como enable para envio assíncrono de tarefas.

enable

model

String

Body

Sim

Modelo a ser usado.

animate-anyone-template-gen2

input.video_url

String

Body

Não

URL do vídeo para geração do modelo de ação.

  • O tamanho do arquivo de vídeo não pode exceder 200 MB.

  • Cada lado do vídeo deve ter entre 200 e 2.048 pixels.

  • A taxa de quadros deve ser de pelo menos 24 fps, com codificação H.264 ou H.265.

  • A duração do vídeo deve variar de 2 a 60 segundos.

  • A proporção do vídeo deve estar entre 1:3 e 3:1.

  • Formatos suportados: MP4, AVI e MOV.

O envio de arquivos suporta apenas links HTTP ou HTTPS. Caminhos de arquivos locais não são aceitos.

http://aaa/bbb.mp4

Parâmetros da resposta

Campo

Tipo

Descrição

Exemplo

output.task_id

String

ID da tarefa enviada. Use este ID para consultar os resultados.

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://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-template-generation/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "animate-anyone-template-gen2",
    "input": {
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241210/cwjmsz/1.mp4"
    }
  }'

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 pelo ID da tarefa 

GET https://{WorkspaceId}.cn-beijing.maas.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 possíveis:

PENDING

RUNNING

SUCCEEDED

FAILED

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

output.template_id

String

ID do modelo de ação retornado pela plataforma. Use este ID com a API de geração de vídeo do AnimateAnyone.

Este ID possui verificação de permissão: a conta que o usa deve corresponder à conta que o gerou.

AACT.xxx.xxx-xxx.xxx

usage.video_duration

Float

Duração do modelo gerado, em segundos.

"video_duration": 10,23

usage.video_ratio

String

Tipo de proporção do modelo 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 \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/<YOUR_TASK_ID>

Exemplo de resposta 

{
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
        "task_status": "SUCCEEDED",
        "template_id": "AACT.xxx.xxx-xxx.xxx"
    },
    "usage": {
        "video_duration": 10.23,
        "video_ratio": "standard"
    }
}
Exemplo de resposta de erro 
{
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-0c46b17950d1",
        "task_status": "FAILED",
        "code": "xxx",
        "message": "xxxxxx"
    }
}

Próximos passos

Use o modelo de ação com a Referência da API de geração de vídeo do AnimateAnyone.

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