POST /chat

curl -X POST https://suite.sundaypyjamas.com/api/v1/chat \
  -H "Authorization: Bearer spj_ai_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Write a professional email greeting."
      }
    ]
  }'

Hello! Here's a professional email greeting for you:

Dear [Recipient's Name],

I hope this email finds you well. I wanted to reach out to discuss [purpose of email].

Best regards,
[Your Name]

curl -X POST https://suite.sundaypyjamas.com/api/v1/chat \
  -H "Authorization: Bearer spj_ai_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "system",
        "content": "You are a technical writer who creates clear, concise documentation."
      },
      {
        "role": "user",
        "content": "Explain what an API is in simple terms."
      }
    ]
  }'

An API (Application Programming Interface) is like a waiter in a restaurant:

- You (the customer) make a request for food
- The waiter takes your order to the kitchen
- The kitchen prepares your meal  
- The waiter brings back your food

Similarly, an API:
- Receives requests from applications
- Processes those requests
- Returns the requested data or performs actions
- Enables different software systems to communicate

APIs make it possible for apps on your phone to get weather data, social media feeds, or payment processing without having to build those services themselves.

curl -X POST https://suite.sundaypyjamas.com/api/v1/chat \
  -H "Authorization: Bearer spj_ai_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "What is machine learning?"
      },
      {
        "role": "assistant",
        "content": "Machine learning is a subset of artificial intelligence (AI) that enables computers to learn and improve from experience without being explicitly programmed for every task."
      },
      {
        "role": "user",
        "content": "Can you give me a simple example?"
      }
    ]
  }'

Sure! Here's a simple example:

**Email Spam Detection**

1. **Training**: You show the computer thousands of emails labeled as "spam" or "not spam"
2. **Learning**: The computer finds patterns - spam emails often have words like "FREE!", "URGENT!", multiple exclamation marks, or suspicious links
3. **Prediction**: When a new email arrives, the computer uses these learned patterns to predict if it's spam or not

The computer "learned" to recognize spam without being programmed with explicit rules like "if email contains 'FREE!' then it's spam." Instead, it discovered these patterns by analyzing examples.

Other everyday examples:
- Netflix recommending movies based on what you've watched
- Your phone's autocorrect learning your typing patterns
- Banks detecting fraudulent transactions

curl -X POST https://suite.sundaypyjamas.com/api/v1/chat \
  -H "Authorization: Bearer spj_ai_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "Generate a Python function to calculate fibonacci numbers."
      }
    ],
    "model": "llama-3.3-70b-versatile"
  }'

curl -X POST https://suite.sundaypyjamas.com/api/v1/chat \
  -H "Authorization: Bearer spj_ai_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "system",
        "content": "You are a marketing copywriter. Write compelling copy that drives action and focuses on benefits."
      },
      {
        "role": "user",
        "content": "Write marketing copy for a productivity app targeting remote workers. Include a headline, 3 key benefits, and a call-to-action."
      }
    ]
  }'

{
  "error": "Messages array is required"
}

{
  "error": "Last message must have valid content"
}

{
  "error": "Invalid request body"
}

{
  "error": "Invalid API key"
}

{
  "error": "Token limit exceeded"
}

{
  "error": "Insufficient permissions"
}

{
  "error": "Rate limit exceeded"
}

{
  "error": "Failed to generate response"
}