API de detecção de imagens EMO - Alibaba Cloud Model Studio: Central de Documentação do Alibaba Cloud

O modelo emo-detect-v1 valida se uma imagem de retrato atende aos requisitos para a geração de vídeo EMO. Use esta API para verificar sua imagem antes de gerar um vídeo e obter as coordenadas da caixa delimitadora exigidas pela API de geração de vídeo EMO.

Importante

Esta API está disponível apenas na região China (Beijing). Use uma chave de API criada na região China (Beijing).

Como funciona

Envie a URL de uma imagem de retrato para o endpoint de detecção.
A API valida a imagem conforme as especificações de retrato do modelo EMO.
Se a imagem for aprovada, a resposta incluirá as coordenadas face_bbox e ext_bbox. Passe esses valores diretamente como parâmetros de solicitação para a API de geração de vídeo EMO.

Pré-requisitos

Conta do Alibaba Cloud Model Studio ativada com uma chave de API. Consulte Crie uma chave de API.

Requisitos de entrada

Requisito	Especificação
Formato	JPG, JPEG, PNG, BMP ou WebP
Resolução mínima	Lado menor >= 400 px
Resolução máxima	Lado maior <= 7.000 px
Método de entrada	Apenas URL HTTP. Caminhos de arquivos locais não são suportados.

Endpoint da API

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

Parâmetros da solicitação

Cabeçalhos

Parâmetro	Tipo	Obrigatório	Descrição
Content-Type	String	Sim	Defina como `application/json`.
Authorization	String	Sim	Sua chave de API no formato Bearer: `Bearer <your-api-key>`.

Corpo

Parâmetro	Tipo	Obrigatório	Descrição
model	String	Sim	Defina como `emo-detect-v1`.
input.image_url	String	Sim	URL HTTP da imagem de retrato a ser validada. A imagem deve atender aos requisitos de formato e resolução listados em Requisitos de entrada.
parameters.ratio	String	Sim	Proporção para validação. Padrão: `"1:1"`. Valores válidos: `"1:1"` (foto de perfil), `"3:4"` (retrato de meio corpo).

Parâmetros da resposta

Parâmetros de resposta de sucesso

Parâmetro	Tipo	Descrição
output.check_pass	Boolean	Resultado da validação. `true`: a imagem atende às especificações de retrato. `false`: a imagem não atende às especificações.
output.face_bbox	Array	Coordenadas da caixa delimitadora do rosto `[x1, y1, x2, y2]`, onde `(x1, y1)` é o canto superior esquerdo e `(x2, y2)` é o canto inferior direito. Retornado apenas quando `check_pass` for `true`. Passe este valor para a API de geração de vídeo EMO.
output.ext_bbox	Array	Coordenadas da caixa delimitadora da área dinâmica `[x1, y1, x2, y2]`. A proporção corresponde ao valor `ratio` da sua solicitação. Retornado apenas quando `check_pass` for `true`. Passe este valor para a API de geração de vídeo EMO.
usage.image_count	Integer	Número de imagens processadas. Usado para faturamento.
request_id	String	Identificador exclusivo da solicitação para solução de problemas.

Parâmetros de resposta de erro

Estes parâmetros são retornados apenas quando a solicitação falha.

Parâmetro	Tipo	Descrição
code	String	Código de erro. Para mais detalhes, consulte Mensagens de erro.
message	String	Descrição do erro. Para mais detalhes, consulte Mensagens de erro.

Exemplos

Solicitação

Antes de executar o comando, defina sua chave de API como variável de ambiente:

export DASHSCOPE_API_KEY=<your-api-key>

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 '{
  "model": "emo-detect-v1",
  "input": {
    "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251225/onmomb/emo.png"
  },
  "parameters": {
    "ratio": "1:1"
  }
}'

Resposta: imagem aprovada

Quando a imagem atende às especificações de retrato, check_pass é true e a resposta inclui ambas as caixas delimitadoras:

{
    "output": {
        "check_pass": true,
        "face_bbox": [302, 286, 610, 593],
        "ext_bbox": [71, 9, 840, 778]
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

Use face_bbox e ext_bbox desta resposta como parâmetros de entrada na sua solicitação de geração de vídeo EMO.

Resposta: imagem reprovada

Quando a imagem não atende às especificações de retrato, check_pass é false:

{
    "output": {
        "check_pass": false,
        "code": "",
        "message": ""
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

Resposta: erro de solicitação

Quando a solicitação é inválida (por exemplo, chave de API ausente ou incorreta), a resposta contém um código e uma mensagem de erro:

{
    "code": "InvalidApiKey",
    "message": "Invalid API-key provided.",
    "request_id": "fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

Para obter a lista completa de códigos de erro, consulte Mensagens de erro.

Códigos de erro

Para consultar códigos de erro e solução de problemas, veja Mensagens de erro.