INRODUÇÃO

A API Cognitiva DS DEVELOP foi desenvolvida com o propósito de fornecer ao mercado e desenvolvedores serviços de visão computacional com padrão de qualidade que utilizam frameworks com potencial opensource como dlib++, opencv, tesseract e openface de uma forma mais simplificada. A API cuida do desenvolvimento, integração e dos treinos dos classificadores customizados como a comunicação com cada framework de acordo com as suas especificações, oferecendo ao usuário um acesso a esse conjunto de tecnologias através ambiente amigável de webservice padrão REST.

CONCEITO

Para iniciar o acesso aos recursos da API o usuário deve fazer seu cadastro no site www.dsdevelop.com.br/apicognitiva/cadastro, após a confirmação do cadastro o usuário recebera um email com um chave de acesso e uma lista de acesso para as chamadas no WebService da API.

A api irá fazer cadastros e relacionamento internamente com token criados por ela mesmo e vai retorná los para o usuário para que ele possa registrar esse token em sua base e assim ter um relacionamento de que pessoa representa cada token.

SERVIÇOS COGNITIVOS PARA PESSOAS

Métodos e explanações

Detecção de face(única ou múltiplas) em imagem

A detecção da face é a primeira parte do processo o usuário deve sempre fazer a detecção antes mesmo de qualquer outro método. Quando esse método é chamado ele irá responder um token em caso de sucesso de encontrar uma face e esse token deve ser usado nas futuras chamadas de funções em cima desta mesma imagem evitando assim ter que subir a imagem novamente a cada chamada. Esse token que retorna da detecção é temporário e deve expirar em 48 horas sendo necessário fazer nova detecção da imagem caso queira reutiliza-la.

Requerimentos de imagem

Formato: JPG
Tamanho: entre de 100*100 a 1024*1024 (pixels)

Request URL
httpss://api.dsdevelop.com.br/api/dsdevelop/face/detect

Request Method
POST

Valor de retorno

Exemplo resposta com faces encontradas:

                            
{
“faces”: [   
    {
      “Bottom”: 191,
      “Code”: “b611f3b5-ce33-4ab5-a24e-6dd0deda7020”,
      “Height”: 678,
      “Left”: 370,
      “Right”: 432,
      “Top”: 129,
      “Width”: 1091
     },
    {
       “Bottom”: 142,
       “Code”: “538a3abb-8e50-4a16-9673-75f508848e29”,
       “Height”: 678,
       “Left”: 453,
       “Right”: 496,
       “Top”: 98,
        “Width”: 1091
      }
],
“size”: 2
}

                        

Sem face encontradas

{
  "faces": [],
  "size": 0
}

Mensagens de erros COMPARAÇÃO ENTRE FACES

Exemplo resposta:

{
    "distance": "0.932"
}

ADICIONAR FACE

A API permite que sejam cadastradas face numa database associada a sua chave de acesso (premissa) para que você possa utilizar o recurso de reconhecimento facial. Nesse item vale uma explicação melhor sobre o processo de reconhecimento.

É necessário realizar um “Enroll” que nada mais é que coletar dados característicos da face em uma imagem para depois usar como parâmetros na análise de reconhecimento e semelhança com outra.

A API necessita que exista ao menos uma imagem para cada pessoa cadastrada no entanto quando se espera um índice de assertividade mais alto se aconselha a usar até 20 imagens de cada face.
É importante também que as imagens tenham ângulos e perspectivas diferente mas que sempre deem visão para os dois olhos isso vai ajudar bastante no aumento da assertividade.

Antes de tentar qualquer abordagem comentada acima é necessário passar a imagem pelo método detect que vai certificar que existe uma face na imagem, após isso deve se coletar o token retornado do método detect para seguir na abordagem:

Request URL 
httpss://api.dsdevelop.com.br/api/dsdevelop/face/person/enroll

Request Method
POST

{
    "code": 1,
    "message": "SUCCESS"
}                

ENROLL DE MÚLTIPLAS IMAGENS

Neste caso será necessário fazer o enroll em dois momentos durante o processo todo. O usuário deve fazer a primeira vez conforme já documentado no item 1 acima e depois utilizar o método abaixo para subir cada uma das demais imagens de face da mesma pessoa em perspetivas diferentes.

Depois de de subir as demais imagens chame o método de enroll novamente com os mesmos parâmetros da primeira chamada que o sistema vai fazer um agrupamento das imagens em um único enroll aumentando assim a assertividade.

Request URL
httpss://api.dsdevelop.com.br/api/dsdevelop/face/person/image

Request Method
POST

{
    "code": 1,
    "message": "SUCCESS"
}               

LISTAR FACES CADASTRADAS

Este método vai listar todas as faces cadastradas a sua Key e Lista, e devolver um array de tokens, esses tokens o usuário deve ter em sua base no sistema local para fazer relacionamento com as chamadas na API.

Request URL
httpss://api.dsdevelop.com.br/api/dsdevelop/face/person

Request Method
POST

Exemplo resposta:

{
    "peoples": [
        "b38e61b72eb9ad8c0e7a08d65d3cadb1",
        "c9c4972f5f966347b79e7b47404ea79e",
        "57a28bef-c1d3-4d5f-9bf9-6f7a15e9f4de",
        "f0c90a94638a236da1f307e5a1a82e44"
    ]
}

REMOVER FACE

Exemplo resposta:

{
    "code": 1,
    "message": "SUCCESS"
}

RECONHECIMENTO DE FACES

Exemplo resposta:

[
    {
        "code": "1c60aa35fdf971fd9def2892f4d78eb6",
        "confidence": 0.7276432771239797,
        "list": ""
    },
    {
        "code": "b38e61b72eb9ad8c0e7a08d65d3cadb1",
        "confidence": 0.555,
        "list": "57365f0ff01e5836ee9744c16e68474e"
    },
    {
        "code": "f1e5b9816e3c05021ef46058ae5af6fd",
        "confidence": 0.534,
        "list": "57365f0ff01e5836ee9744c16e68474e"
    },
    {
        "code": "787f7bf2-b964-4677-b136-e30a676412de",
        "confidence": 0.519,
        "list": "57365f0ff01e5836ee9744c16e68474e"
    }
]
                    

DETECÇÃO DE 68 PONTOS EM FACE (LANDMARK)

Ilustração de Referencia de cada ponto