API Overview

http://localhost:5000

curl -X POST http://localhost:5000/api/chat \
  -H "Content-Type: application/json" \
  -d '{"figure_id": "einstein", "message": "Hello!"}'

{
  "response": "Ah, greetings! How wonderful to make your acquaintance...",
  "figure": {
    "id": "einstein",
    "name": "Albert Einstein",
    "title": "Theoretical Physicist"
  }
}

{
  "error": "Figure not found"
}

{
  "error": "The spirits are overwhelmed with visitors right now. Please wait a moment and try again, or select a different AI model from the dropdown."
}

{
  "models": [
    {
      "id": "google/gemma-3-12b-it:free",
      "name": "Gemma 3 12B",
      "tier": "swift"
    },
    {
      "id": "openai/gpt-4o-mini",
      "name": "GPT-4o Mini",
      "tier": "balanced"
    },
    {
      "id": "anthropic/claude-sonnet-4",
      "name": "Claude Sonnet 4",
      "tier": "advanced"
    }
  ],
  "default": "google/gemma-3-12b-it:free"
}

{
  "status": "healthy",
  "api_key_configured": true,
  "api_key_length": 64
}

{
  "status": "degraded",
  "api_key_configured": false,
  "api_key_length": 0,
  "warning": "OPENROUTER_API_KEY is not set"
}