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.
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 |
|---|---|
|  |
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 |
|
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:
| |
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 |
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 objectInformações de saída da tarefa.
Propriedades bbox_face array of integerCoordenadas 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 integerCoordenadas 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 stringCódigo de erro (retornado quando a detecção falha). Consulte 错误码 para detalhes.message stringMensagem de erro (retornada quando a detecção falha). Consulte 错误码 para detalhes. | |
request_id stringIdentificador exclusivo da requisição para rastreamento e solução de problemas. | |
usage objectEstatísticas de saída.
Propriedades image_count integerNú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.Imagens fora de conformidade ainda geram cobrança, pois a detecção foi concluída. | |
message stringMensagem de erro detalhada. Retornada apenas para requisições com falha. Consulte 错误码. | |
request_id stringIdentificador 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.