Alibaba Cloud Model Studio:Referência da API de detecção de imagens do LivePortrait

O modelo LivePortrait-detect verifica se as imagens de entrada atendem às especificações do LivePortrait. Este documento descreve como chamar a API de detecção.

Visão geral do modelo

Modelo	Descrição
liveportrait-detect	Detecta se as imagens de entrada atendem às especificações de retrato exigidas pelo modelo liveportrait.

HTTP

Descrição do recurso

Este recurso verifica se as imagens de entrada cumprem as especificações de retrato necessárias para a geração de vídeo com LivePortrait.

Pré-requisitos

• Crie uma chave de API no Alibaba Cloud Model Studio. Consulte Obter uma chave de API.

Limitações de entrada

• Formatos de imagem compatíveis: JPEG, JPG, PNG, BMP e WebP.
• A imagem deve ter menos de 10 MB, proporção ≤2 e lado maior ≤4096 pixels.
• Envie as imagens exclusivamente por URLs HTTP (caminhos locais não são compatíveis).

Envio de tarefa

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect

Parâmetros da solicitação

Campo	Tipo	Local do parâmetro	Obrigatório	Descrição	Exemplo
Content-Type	String	Header	Sim	Tipo de conteúdo da solicitação (defina como application/json).	application/json
Authorization	String	Header	Sim	Chave de API no formato Bearer.	Bearer d1**2a
model	String	Body	Sim	Nome do modelo (defina como liveportrait-detect).	liveportrait-detect
input.image_url	String	Body	Sim	URL da imagem a ser verificada. A imagem deve ter menos de 10 MB, proporção ≤2 e lado maior ≤4096 pixels. Formatos compatíveis: JPEG, JPG, PNG, BMP e WebP. O upload de arquivos aceita apenas links HTTP ou HTTPS. Caminhos de arquivo local não são compatíveis.	"image_url": "http://a/a.jpg"

Parâmetros de resposta

Campo	Tipo	Descrição	Exemplo
output.pass	Bool	Indica se a imagem passou na validação.	"pass":true/false
output.message	String	Descrição do resultado da validação.	"message":No human face detected.
request_id	String	Identificador único da solicitação.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Motivo da falha

output.message	Descrição
No human face detected	Nenhuma face detectada. Ocorre quando a face é muito pequena, está de perfil ou obstruída.

Exemplo de solicitação

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "liveportrait-detect",
  "input": {
      "image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png"
  }
}'

Exemplo de resposta (aprovado)

{
    "output": {
        "pass": true,
        "message": ""
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "a92e2ffd-9263-44ba-92c5-xxxxxx"
}

Exemplo de resposta (falhou)

{
    "output": {
        "pass": false,
        "message": "No human face detected."
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

Exemplo de resposta (erro)

{
    "code": "InvalidParameter.UnsupportedFileFormat",
    "message": "Input files format not supported.",
    "request_id": "788b30fe-05f6-999f-a0b1-xxxxxx"
}

Códigos de erro

Consulte Códigos de erro para ver os códigos de erro comuns.