Skip to main content
AnimateAnyone: Generate dance videos from images

Referência da API de detecção de imagem do AnimateAnyone

Use a API de detecção para verificar se uma imagem de entrada é adequada para geração de vídeo com o AnimateAnyone.
Este documento aplica-se apenas à região China (Beijing). Para usar os modelos, obtenha uma chave de API da região China (Beijing).

Visão geral do modelo

Modelo

Descrição

animate-anyone-detect-gen2

Verifica se uma imagem de entrada é compatível com o modelo animate-anyone-gen2.

Exemplos

Exemplos válidos

Foto de corpo inteiro

Foto da cintura para cima

  • Uma única pessoa deve estar visível da cabeça aos pés, sem obstruções.

  • A pessoa deve estar voltada para a câmera, sem giros ou inclinações significativas.

Recommended full-body front visualize for AA

  • Uma única pessoa deve estar visível da cintura para cima, sem obstruções.

  • A pessoa deve estar voltada para a câmera, sem giros ou inclinações significativas.

Recommended half-body front visualize for AA

Exemplos inválidos

Vista lateral(Não voltado para frente)

Iluminação inadequada(Pessoa pouco nítida)

Obstruções(Mãos cobertas ou segurando objetos)

Fundo complexo

Várias pessoas

Incorrect example: side visualize

Incorrect example: poor lighting

Incorrect example: holding object

Incorrect example: complex background

Incorrect example: multiple people

HTTP

Pré-requisitos

Endpoint da solicitação

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect

Parâmetros da solicitação

Campo

Tipo

Localização

Obrigatório

Descrição

Exemplo

Content-Type

String

Header

Sim

Formato da solicitação.

application/json

Authorization

String

Header

Sim

Chave de API com o prefixo Bearer.

Bearer d1**2a

model

String

Body

Sim

Nome do modelo de detecção.

animate-anyone-detect-gen2

input.image_url

String

Body

Sim

URL da imagem a ser verificada (deve ser acessível publicamente via HTTP/HTTPS).

"image_url": "http://a/a.jpg"

Parâmetros da resposta

Campo

Tipo

Descrição

Exemplo

output.check_pass

Boolean

Indica se a imagem passou na detecção.

true

output.bodystyle

String

Estilo corporal detectado:

  • half (foto da cintura para cima)

  • full (foto de corpo inteiro).

half

output.reason

String

Motivo da falha na detecção (retornado apenas quando check_pass é false).

The input image has no human body...

usage.image_count

Integer

Número de imagens verificadas.

1

request_id

String

Identificador da solicitação.

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

Exemplo de solicitação

curl --location --request POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "animate-anyone-detect-gen2",
  "input": {
      "image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251224/pkswoc/p883941.png"
  }
}'

Exemplos de resposta bem-sucedida

Imagem aprovada na detecção
{
    "output": {
        "bodystyle": "full",
        "check_pass": true
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "76df937d-6eb6-40aa-9ccf-xxxxxx"
}
Imagem reprovada na detecção
{
    "output":{
        "check_pass": false,
        "reason": "The input image has no human body. Upload another image that contains a single person.",
        "bodystyle": ""
    },
    "usage":{
        "image_count": 1
    },
    "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

Exemplo de solicitação com falha

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

Próximos passos

Se a imagem for aprovada na detecção, use-a para a geração de vídeo com AnimateAnyone.

Códigos de erro

Para obter uma lista de códigos de status gerais, consulte Códigos de erro.
Referência da API de Geração de Texto
Geração de Imagens
  • FAQ
Geração de Vídeo
Áudio
API em tempo real
Incorporação de Texto
Produção de Modelos