Chat API

curl -X POST http://localhost:5000/api/chat \
  -H "Content-Type: application/json" \
  -d '{
    "figure_id": "einstein",
    "message": "What inspired your theory of relativity?",
    "history": [
      {
        "role": "user",
        "content": "Hello Professor Einstein!"
      },
      {
        "role": "assistant",
        "content": "Ah, greetings! How wonderful to make your acquaintance."
      }
    ],
    "model": "openai/gpt-4o-mini"
  }'

{
  "response": "Ah, what a wonderful question! You know, it all started with a thought experiment when I was just a young patent clerk in Bern. I imagined myself riding alongside a beam of light, traveling at the speed of light itself. What would I see? Would the light appear frozen, stationary beside me?\n\nThis simple question troubled me deeply, and it made me realize that our notions of absolute time and space couldn't be correct. The breakthrough came when I understood that time itself is relative - it flows differently depending on how fast you're moving! The faster you go, the slower time passes for you relative to someone standing still.\n\nBut tell me, what draws you to relativity? Is it the physics that fascinates you, or perhaps the philosophical implications?",
  "figure": {
    "id": "einstein",
    "name": "Albert Einstein",
    "title": "Theoretical Physicist",
    "birth_year": 1879,
    "death_year": 1955,
    "era": "Modern Era",
    "tagline": "Father of Relativity, Nobel Laureate"
  }
}

{
  "error": "No figure_id provided"
}

{
  "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.",
  "figure": { /* figure object */ }
}

curl -X POST http://localhost:5000/api/chat/stream \
  -H "Content-Type: application/json" \
  -d '{
    "figure_id": "einstein",
    "message": "Tell me about your theory of relativity"
  }'

Content-Type: text/event-stream
Cache-Control: no-cache
Connection: keep-alive
X-Accel-Buffering: no

data: {"content": "text chunk"}

data: {"content": "Ah, "}

data: {"content": "what a "}

data: {"content": "wonderful "}

data: {"content": "question! "}

data: {"content": "You know, "}

data: {"content": "it all started..."}

data: {"done": true}

const response = await fetch('http://localhost:5000/api/chat/stream', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    figure_id: 'einstein',
    message: 'What inspired your theory of relativity?'
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  
  const chunk = decoder.decode(value);
  const lines = chunk.split('\n');
  
  for (const line of lines) {
    if (line.startsWith('data: ')) {
      const data = JSON.parse(line.slice(6));
      
      if (data.content) {
        console.log(data.content); // Stream content
      } else if (data.done) {
        console.log('Stream complete');
      } else if (data.error) {
        console.error('Error:', data.error);
      }
    }
  }
}

data: {"error": "The spirits are overwhelmed with visitors. Please wait a moment and try again, or select a different AI model.", "rate_limited": true}