Skip to main content
Vídeo de Canto e Atuação a Partir de Imagem – EMO

Referência da API de detecção de imagens EMO

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.

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

Como funciona

  1. Envie a URL de uma imagem de retrato para o endpoint de detecção.
  2. A API valida a imagem conforme as especificações de retrato do modelo EMO.
  3. 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

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âmetroTipoObrigatórioDescrição
modelStringSimDefina como emo-detect-v1.
input.image_urlStringSimURL 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.ratioStringSimProporçã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.
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
Referência da API de detecção de imagens EMO - Alibaba Cloud Model Studio