---
title: "Adicionar face à coleção"
method: POST
path: "/faces/adicionar"
tags: ["Biometria Facial 1:N"]
---

# Adicionar face à coleção

`POST /faces/adicionar`

### Descrição

A adição de faces permite incluir novas imagens de rosto em uma **coleção previamente criada** na **Biometria Facial 1:N** do **BigID**. Cada face enviada é processada por Inteligência Artificial e convertida em uma representação vetorial criptografada, que passa a compor a base de referência utilizada em comparações futuras por similaridade (1:N).

As faces são associadas a identificadores únicos definidos pelo cliente, ampliando gradualmente a coleção e viabilizando fluxos como autenticação biométrica, login contínuo, controle de acesso e verificação de identidade. As imagens originais **não são armazenadas**, garantindo maior privacidade e segurança no tratamento dos dados biométricos.

Para mais informações sobre casos de uso, principais dúvidas e orientações de aplicação, acesse [Biometria Facial](/docs/biometria-facialfacematch).

### Tabela de preços

A cobrança é realizada conforme o volume mensal de operações, de acordo com a tabela abaixo:

| Operações realizadas no mês | Valor por operação |
|:---------------------------:|:------------------:|
| 1 – 10.000 | R$ 0,170 |
| 10.001 – 50.000 | R$ 0,162 |
| 50.001 – 100.000 | R$ 0,153 |
| 100.001 – 500.000 | R$ 0,146 |
| 500.001 – 1.000.000 | R$ 0,138 |
| 1.000.001 – 5.000.000 | R$ 150.000,00 (preço fixo) |
| Acima de 5.000.000 | [Entre em contato](mailto:comercial@bigdatacorp.com.br) |

## Request body

- AddFaceRequest — Objeto de request para adição de faces à coleção da Biometria Facial 1:N.
  - `faces` string[], required — Lista de pares `imagem,CPF`, representando as faces a serem adicionadas.
  - `collection` string, required — Identificador único da coleção de destino.

## Response `200`

Resultado da adição de faces à coleção.

- AddFaceResult — Estrutura de retorno da operação de adição de faces à coleção.
  - `images_ids` string[] — Lista de identificadores das imagens adicionadas.
  - `ticketId` string — Identificador da operação.
  - `resultCode` integer — Código de resultado.
  - `success` boolean — Indica se a operação foi bem-sucedida.
  - `message` string — Mensagem de resultado.

---

[API](https://skmtc.dev/bigdatacorp/apis/bigid.md) · [All operations](https://skmtc.dev/bigdatacorp/apis/bigid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdatacorp/bigid/revisions/74abe72d7efc/schema)