Referência da API de detecção de imagens Emoji - Alibaba Cloud Model Studio: Central de Documentação do Alibaba Cloud

Verifica se uma imagem de entrada atende aos requisitos do modelo Emoji. Se a detecção for aprovada, o modelo retorna as coordenadas da área facial (bbox_face) e da área dinâmica estendida (ext_bbox_face) para geração de vídeo.

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

Visão geral do modelo

Modelo	Descrição
emoji-detect-v1	Verifica se uma imagem de entrada atende às especificações necessárias para a Geração de vídeo Emoji. O modelo retorna as coordenadas da área facial (bbox_face) e da área de expressão estendida (ext_bbox_face) para geração de vídeo.

Requisitos da imagem de entrada

Exemplo de imagem em conformidade (detecção aprovada)

Requisitos da imagem	Exemplo em conformidade
Retrato único voltado para frente Rosto não obstruído (por objetos como mãos, cabelos ou acessórios) Expressão natural, sem exageros Cabeça ereta, sem inclinação significativa

Exemplos de imagens fora de conformidade (detecção reprovada)

Mão visível próxima ao rosto	Rosto obstruído	Expressão exagerada	Inclinação excessiva da cabeça

Pré-requisitos

Obtenha uma chave de API e exporte a chave de API como variável de ambiente.

HTTP

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

Parâmetros da requisição

Detecção de conformidade de retrato

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

Cabeçalhos da requisição

Content-Type string (Obrigatório)

Tipo de conteúdo da requisição. Deve ser application/json.

Authorization string (Obrigatório)

Autentica a requisição com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx.

Corpo da requisição

model string (Obrigatório)

Defina como emoji-detect-v1.

input object (Obrigatório)

Imagem de entrada para detecção.

Propriedades

image_url string (Obrigatório)

URL pública da imagem (compatível com HTTP/HTTPS).

Limites:

Formato da imagem: JPEG, JPG, PNG, BMP ou WEBP.
Resolução da imagem: largura e altura entre 400 e 7.000 pixels.
Tamanho do arquivo: máximo de 10 MB.

Exemplo: https://help-static-aliyun-doc.aliyuncs.com/xxx.png.

parameters object (Obrigatório)

Parâmetros de detecção.

Propriedades

ratio string (Obrigatório)

Proporção da área de detecção. Para vídeo Emoji, defina como 1:1.

Exemplo: 1:1.

Parâmetros da resposta

Detecção aprovada

Se a detecção for aprovada, salve bbox_face e ext_bbox_face para uso posterior na Emoji 视频生成 (parâmetros input.face_bbox e input.ext_bbox). Há cobrança (consulte usage.image_count).

{
        "output": {
            "bbox_face": [212.194.460.441],
            "ext_bbox_face": [63.30.609.575]
        },
        "usage": {
            "image_count": 1
        },
        "request_id": "78becbc4-f7f7-41ea-9e38-xxxxxx"
    }

Falha na detecção

Mesmo se a detecção falhar, haverá cobrança (consulte usage.image_count). Para solução de problemas, consulte Error Messages.

{
    "output": {
        "code": "InvalidFile.FacePose",
        "message": "The pose of the detected face is invalid, please upload other image with the expected oriention."
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "ed0d0d8f-e55a-4144-b855-xxxxxx"
}

Falha na requisição

Falhas na requisição não geram cobrança (nenhum usage.image_count retornado). Para solução de problemas, consulte Error Messages.

{
    "request_id": "5e1fefbd-fa7a-4e59-82a0-xxxxxx",
    "code": "InvalidParameter",
    "message": "Required body invalid, please check the request body format."
}

output object

Informações de saída da tarefa.

Propriedades

bbox_face array of integer

Coordenadas da área facial em pixels: [x1, y1, x2, y2] (pontos superior esquerdo e inferior direito). Retornado apenas se a detecção for aprovada.

Use para input.face_bbox na API de Emoji 视频生成.

Exemplo: [212.194.460.441].

ext_bbox_face array of integer

Coordenadas da área de expressão estendida em pixels: [x1, y1, x2, y2] (pontos superior esquerdo e inferior direito). Retornado apenas se a detecção for aprovada.

Use para input.ext_bbox na API de Emoji 视频生成.

Exemplo: [63.30.609.575].

code string

Código de erro (retornado quando a detecção falha). Consulte 错误码 para detalhes.

message string

Mensagem de erro (retornada quando a detecção falha). Consulte 错误码 para detalhes.

request_id string

Identificador exclusivo da requisição para rastreamento e solução de problemas.

usage object

Estatísticas de saída.

Propriedades

image_count integer

Número de imagens detectadas (sempre 1, usado para faturamento). Requisições bem-sucedidas geram cobrança independentemente do resultado da detecção; requisições com falha não geram cobrança. Consulte Model pricing para detalhes de faturamento.

ObservaçãoImagens fora de conformidade ainda geram cobrança, pois a detecção foi concluída.

message string

Mensagem de erro detalhada. Retornada apenas para requisições com falha. Consulte 错误码.

request_id string

Identificador exclusivo da requisição para rastreamento e solução de problemas.

Faturamento e limitação de taxa

Para cota gratuita e preço unitário do modelo, consulte Modelos recomendados.
Para limites de taxa, consulte Limitação de taxa.

Códigos de erro

Para solucionar erros, consulte Códigos de erro.