> ## 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 de VU: detecta fotocopias, capturas de pantalla, deepfakes y alteraciones sobre una selfie antes de aprobar a una persona.

El servicio de **Antispoofing Facial** analiza una selfie y responde una sola pregunta: ¿la imagen proviene de una persona real presente frente a la cámara, o de un intento de suplantación?

Detecta fotocopias, capturas de pantalla, bordes de otra pantalla dentro del cuadro, marcas de agua, alteraciones cromáticas y deepfakes generados por IA. Se integra con una única llamada HTTP y no requiere SDK.

## La regla de decisión

Esta es la parte más importante de la integración. Escríbala en positivo:

```js theme={null}
// Aprobar exige las dos condiciones. Cualquier otra cosa NO es una aprobación.
if (status === 200 && body.spoofing === false) {
  aprobar();
} else {
  noAprobar();
}
```

<Warning>
  **No apruebe por descarte.** No existe un único código que signifique «rechazado»: el veredicto de suplantación llega con `200`, pero una imagen sin rostro llega con `422` y también trae `spoofing: true`. Si su condición es «rechazar si el código es X», cualquier respuesta inesperada termina aprobada.
</Warning>

No decida sobre `errorCode`, `values`, `confidence` ni `info`. Esos campos son diagnóstico: sirven para su log y para abrir un ticket con contexto, cambian entre versiones y no forman parte del contrato.

## Endpoints

| Método | Ruta | Para qué sirve |
| - | - | - |
| `GET` | `/version` | Verificar conectividad y credenciales. Evalúe el código de estado, no el cuerpo. |
| `POST` | `/inference` | Analizar una imagen y obtener el veredicto. |

La URL base depende del ambiente y se la entrega VU junto con su api-key. En los ejemplos aparece como `BASE_URL`.

## Autenticación

Cada llamada lleva la cabecera `Api-Key` con la clave de su ambiente.

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

<Warning>
  La api-key vive en su backend. Nunca la incruste en una app móvil ni en el front-end: cualquiera puede extraerla del binario o del bundle.
</Warning>

## Un ejemplo 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=="
  }'
```

Una aprobación se ve así, recortada a los campos que importan:

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

`id` es el identificador de la transacción. Regístrelo siempre: es lo primero que le va a pedir soporte.

## Ambientes

<Note>
  **Homologación puede ir adelantada respecto de producción.** UAT también valida versiones preproductivas, así que puede diferir en tiempos de respuesta y en el resultado del análisis. Úselo para certificar su integración —el contrato, los códigos, el manejo de errores—, no como referencia de performance ni para comparar veredictos imagen por imagen entre ambientes.
</Note>

## Continuar

<CardGroup cols={3}>
  <Card title="Integración" icon="code" href="/vucs/antispoofing-facial/integracion">
    Prepare la imagen, arme la llamada y valide su integración antes de producción.
  </Card>

  <Card title="Respuestas" icon="list-check" href="/vucs/antispoofing-facial/respuestas">
    Qué trae cada respuesta, cómo se comporta `info` y qué componente bloqueó.
  </Card>

  <Card title="Errores" icon="triangle-exclamation" href="/vucs/antispoofing-facial/errores">
    Códigos, cuáles son suyos, cuáles del servicio y cuáles se reintentan.
  </Card>
</CardGroup>


## Related topics

- [Integrar Antispoofing Facial](/vucs/antispoofing-facial/integracion.md)
- [Errores y diagnóstico](/vucs/antispoofing-facial/errores.md)
- [Interpretación de respuestas](/vucs/face-analysis/respuestas.md)
- [VU Cloud Services](/vucs/introduccion.md)
- [Documentación técnica de VU](/index.md)


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