Todos os produtos
Search

Este produto

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

    Central de documentação

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

    Última atualização: Jul 02, 2026

    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.

    Importante

    Este 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

    image.png

    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

    image.png

    image.png

    image.png

    image.png

    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.

    Nota

    Imagens 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

    Códigos de erro

    Para solucionar erros, consulte Códigos de erro.