Skip to main content
Imagem para vídeo de transmissão - LivePortrait

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.

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

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

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.
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