YOLO_FastAPI2 / README.md
Ercik's picture
Upload 4 files
3ffbf5e verified

🧠 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:

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

Recibirás una respuesta como:

{
  "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.