API_README.md

# CareLink Medical - API de Análise de Exames

API FastAPI para análise de exames médicos usando IA (Google MedGemma).

## 🚀 Funcionalidades

- ✅ Upload de imagens de exames médicos
- ✅ Análise automática com IA (MedGemma 4B)
- ✅ Retorno de análise estruturada em JSON
- ✅ Suporte a CORS para integração com frontend
- ✅ Documentação interativa (Swagger/OpenAPI)
- ✅ Health check endpoint

## 📦 Instalação

```bash
# Instalar dependências
pip install -r requirements.txt

# Fazer login no Hugging Face
huggingface-cli login
```

## 🏃 Executar

```bash
uvicorn app:app --reload --host 0.0.0.0 --port 8000
```

Acesse:
- API: http://localhost:8000
- Docs: http://localhost:8000/docs

## 📡 Endpoints

### `POST /api/analyze-exam`
Envia imagem para análise com IA

**Body:** FormData
- `file`: Arquivo de imagem (JPEG, PNG, etc)
- `patient_name`: Nome do paciente (opcional)

**Response:**
```json
{
  "success": true,
  "timestamp": "2025-12-25T10:30:00",
  "patient_name": "Maria Silva",
  "file_info": {
    "filename": "exame.jpg",
    "content_type": "image/jpeg",
    "size_bytes": 245678
  },
  "analysis": {
    "model": "google/medgemma-4b-it",
    "result": "Análise médica detalhada...",
    "confidence": "high"
  }
}
```

## 🔧 Tecnologias

- FastAPI
- Transformers (Hugging Face)
- Google MedGemma 4B
- Pillow (PIL)
- Uvicorn

## ⚠️ Notas

- Requer token do Hugging Face
- Primeira execução baixa o modelo (~8GB)
- GPU recomendada para melhor performance