README.md

---
title: Surya OCR API
emoji: 📝
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: mit
---

# Surya OCR API

API REST para reconocimiento de texto manuscrito usando **Surya OCR**.

## Caracteristicas

- Reconocimiento de texto manuscrito de alta precision
- Modelo Surya OCR (2024)
- API REST con FastAPI
- Documentacion interactiva en `/docs`

## Uso

### Endpoint principal

```
POST /recognize
```

Sube una imagen y recibe el texto reconocido.

### Ejemplo con curl

```bash
curl -X POST "https://tu-space.hf.space/recognize" \
  -F "file=@tu_imagen.jpg"
```

### Respuesta

```json
{
  "exito": true,
  "texto": "Texto reconocido",
  "confianza": 0.95,
  "lineas": [
    {"texto": "Linea 1", "confianza": 0.98},
    {"texto": "Linea 2", "confianza": 0.92}
  ]
}
```

## Endpoints

| Metodo | Ruta | Descripcion |
|--------|------|-------------|
| GET | `/` | Informacion de la API |
| GET | `/health` | Estado del servicio |
| GET | `/docs` | Documentacion Swagger |
| POST | `/recognize` | Reconocer texto en imagen |

## Tecnologias

- **Surya OCR** - Modelo de reconocimiento
- **FastAPI** - Framework web
- **Python 3.11** - Lenguaje
- **Docker** - Contenedor