README.md

# 🧠 API de Detección con Autenticación (FastAPI + JWT + YOLOv8)

Este proyecto es una API construida con **FastAPI**, que integra:

- 🔐 Autenticación con JWT
- 📷 Recepción de imágenes mediante `POST`
- 🧠 Detección de objetos usando **YOLOv8n**
- 🖼️ Devolución de la imagen con cajas (bounding boxes) dibujadas

---

## 🚀 ¿Cómo usarlo?

### 1. Obtener un token JWT

Realiza una petición `POST` al endpoint `/token` con este body:

```json
{
  "username": "uriel",
  "password": "1234"
}
```

Recibirás una respuesta como:

```json
{
  "access_token": "<TU_TOKEN>",
  "token_type": "bearer"
}
```

---

### 2. Autorizarte en Swagger UI

Haz clic en el botón "Authorize" 🔓 y escribe:

```
Bearer <TU_TOKEN>
```

Esto habilitará los endpoints protegidos.

---

### 3. Subir una imagen al endpoint protegido

Envía una imagen al endpoint:

```
POST /detectar/
```

El resultado será una imagen con cajas de detección dibujadas.

---

## 🧪 Usuario de prueba

- **Usuario:** `uriel`
- **Contraseña:** `1234`

---

## 📦 Dependencias

Las dependencias están definidas en `requirements.txt` e incluyen:

- FastAPI
- Uvicorn
- Ultralytics (YOLOv8)
- Python-Jose (JWT)
- Passlib (bcrypt)
- Pillow

---

## 👨‍💻 Autor

Este proyecto fue creado por Uriel Escalona para demostrar una API segura y funcional con FastAPI + Visión por Computadora.