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

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

# Fazer login no Hugging Face
huggingface-cli login

🏃 Executar

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:

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