> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vu-one.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Antispoofing Facial

> API de antispoofing facial da VU: detecta fotocópias, capturas de tela, deepfakes e alterações em uma selfie antes de você aprovar uma pessoa.

O serviço de **Antispoofing Facial** analisa uma selfie e responde a uma única pergunta: esta imagem veio de uma pessoa real diante da câmera ou de uma tentativa de falsificação?

Detecta fotocópias, capturas de tela, a borda de outra tela dentro do quadro, marcas d'água, alterações cromáticas e deepfakes gerados por IA. Integração com uma única chamada HTTP, sem SDK.

## A regra de decisão

Esta é a parte mais importante da integração. Escreva-a na forma positiva:

```js theme={null}
// Aprovar exige as duas condições. Qualquer outra coisa NÃO é uma aprovação.
if (status === 200 && body.spoofing === false) {
  aprovar();
} else {
  naoAprovar();
}
```

<Warning>
  **Nunca aprove por exclusão.** Não existe um código único que signifique «rejeitado»: o veredito de falsificação chega com `200`, enquanto uma imagem sem rosto chega com `422` e *também* traz `spoofing: true`. Se a sua condição for «rejeitar quando o código for X», toda resposta inesperada acaba aprovada.
</Warning>

Não decida com base em `errorCode`, `values`, `confidence` ou `info`. Esses campos são diagnóstico: servem para o seu log e para abrir um chamado com contexto. Mudam entre versões e não fazem parte do contrato.

## Endpoints

| Método | Caminho | Para que serve |
| - | - | - |
| `GET` | `/version` | Verificar conectividade e credenciais. Avalie o código de status, não o corpo. |
| `POST` | `/inference` | Analisar uma imagem e obter o veredito. |

A URL base depende do ambiente e é fornecida pela VU junto com a sua api-key. Nos exemplos ela aparece como `BASE_URL`.

## Autenticação

Toda chamada leva o cabeçalho `Api-Key` com a chave do seu ambiente.

```bash theme={null}
curl -X GET "$BASE_URL/version" \
  -H "Api-Key: $VU_AS_FACE_API_KEY"
```

<Warning>
  A api-key vive no seu backend. Nunca a embuta em um app móvel nem no front-end: qualquer pessoa consegue extraí-la do binário ou do bundle.
</Warning>

## Um exemplo completo

```bash theme={null}
curl -X POST "$BASE_URL/inference" \
  -H "Api-Key: $VU_AS_FACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "info": "onboarding-12345",
    "logAnonymity": true,
    "image": "/9j/4AAQSkZJRgABAQAAAQABAAD...v9Un0ooqDE//2Q=="
  }'
```

Uma aprovação se parece com isto, reduzida aos campos que importam:

```json theme={null}
{
  "id": "f80aaaf6-b3fe-44ab-9388-79d42b7a5f0e",
  "code": 200,
  "spoofing": false,
  "message": "Machine Learning indicates not Spoofing",
  "confidence": 99,
  "benchmark": 248
}
```

`id` é o identificador da transação. Registre-o sempre: é a primeira coisa que o suporte vai pedir.

## Ambientes

<Note>
  **O ambiente de homologação pode estar à frente da produção.** Ele também valida versões pré-produtivas, então pode diferir em tempo de resposta e no resultado da análise. Use-o para certificar a sua integração — o contrato, os códigos, o tratamento de erros —, não como referência de performance nem para comparar vereditos imagem a imagem entre ambientes.
</Note>

## Continuar

<CardGroup cols={3}>
  <Card title="Integração" icon="code" href="/pt/vucs/antispoofing-facial/integracao">
    Prepare a imagem, monte a chamada e valide a integração antes da produção.
  </Card>

  <Card title="Respostas" icon="list-check" href="/pt/vucs/antispoofing-facial/respostas">
    O que cada resposta traz, como `info` se comporta e qual componente bloqueou.
  </Card>

  <Card title="Erros" icon="triangle-exclamation" href="/pt/vucs/antispoofing-facial/erros">
    Códigos, de quem é cada problema e quais podem ser repetidos.
  </Card>
</CardGroup>


## Related topics

- [Integrar o Antispoofing Facial](/pt/vucs/antispoofing-facial/integracao.md)
- [Erros e diagnóstico](/pt/vucs/antispoofing-facial/erros.md)
- [Interpretação de respostas](/pt/vucs/face-analysis/respostas.md)
- [VU Cloud Services](/pt/vucs/introducao.md)
- [Face Analysis](/pt/vucs/face-analysis/introducao.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.