Quick Start Guide

Get Your API Key

Start by generating your API key from your workspace settings.

Access Workspace Settings

Log into your SundayPyjamas workspace
Navigate to Settings → API tab
Click “Generate API Key”
Give your key a descriptive name (optional)

Save Your Key Securely

spj_ai_a1b2c3d4e5f6789012345678901234567890abcdef123456789012345678901234

Copy and store this key immediately - it won’t be shown again!

Make Your First Request

Choose your preferred method to make your first API call:

JavaScript
Python
cURL

const response = await fetch('https://suite.sundaypyjamas.com/api/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer spj_ai_your_api_key_here',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    messages: [
      {
        role: 'user',
        content: 'Hello! Write me a professional email greeting.'
      }
    ]
  })
});

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

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  result += decoder.decode(value);
}

console.log(result);

import requests

response = requests.post(
    'https://suite.sundaypyjamas.com/api/v1/chat',
    headers={
        'Authorization': 'Bearer spj_ai_your_api_key_here',
        'Content-Type': 'application/json',
    },
    json={
        'messages': [
            {
                'role': 'user',
                'content': 'Hello! Write me a professional email greeting.'
            }
        ]
    },
    stream=True
)

full_response = ''
for chunk in response.iter_content(chunk_size=None, decode_unicode=True):
    if chunk:
        full_response += chunk

print(full_response)

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": "Hello! Write me a professional email greeting."
      }
    ]
  }'

Understanding the Response

The API returns a streaming text response. You’ll receive the AI’s response in real-time:

Hello! Here's a professional email greeting:

Dear [Recipient's Name],

I hope this email finds you well. I wanted to reach out to...

Common Use Cases

Content Generation

Generate blog posts, emails, and marketing copy with custom prompts.

Chat Interface

Build conversational AI interfaces with streaming responses.

Email Writing

Create professional emails for various purposes and audiences.

Code Assistance

Get help with programming tasks and code generation.

Best Practices

Secure Your API Key

# Use environment variables
export SUNDAYPYJAMAS_API_KEY="spj_ai_your_key_here"

// In your code
const apiKey = process.env.SUNDAYPYJAMAS_API_KEY;

Handle Errors Gracefully

try {
  const response = await fetch('/api/v1/chat', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ messages })
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error);
  }

  // Handle streaming response...
} catch (error) {
  console.error('API Error:', error.message);
}

Optimize for Token Usage

Be concise and clear in your prompts to minimize token usage and costs.

// ❌ Too verbose
const prompt = "I would like you to please help me write a very professional business email that I need to send to my client regarding the project status update...";

// ✅ Concise and clear  
const prompt = "Write a professional email to a client with a project status update.";

Next Steps

Authentication Guide

Learn about API key management, security, and permissions.

Chat API Reference

Explore complete endpoint documentation with all parameters.

Code Examples

View ready-to-use implementations in multiple languages.

Rate Limits

Understand usage guidelines and optimization strategies.

Troubleshooting

"Invalid API key" Error

Check your API key format: spj_ai_[64-characters]
Ensure the key is active and not deleted
Verify the Authorization header: Bearer spj_ai_...

"Token limit exceeded" Error

Check your workspace usage in settings
Optimize prompts to use fewer tokens
Consider upgrading your plan

Network/Connection Errors

Verify the API URL is correct
Check your internet connection
Ensure HTTPS is used, not HTTP

Ready to build amazing AI-powered applications? Start with the Chat API documentation or explore our code examples to see what’s possible!

Getting Started

API Documentation

Code Examples

Development

Get Your API Key

Make Your First Request

Understanding the Response

Common Use Cases

Content Generation

Chat Interface

Email Writing

Code Assistance

Best Practices

Secure Your API Key

Handle Errors Gracefully

Optimize for Token Usage

Next Steps

Authentication Guide

Chat API Reference

Code Examples

Rate Limits

Troubleshooting

​Get Your API Key

​Make Your First Request

​Understanding the Response

​Common Use Cases

Content Generation

Chat Interface

Email Writing

Code Assistance

​Best Practices

​Secure Your API Key

​Handle Errors Gracefully

​Optimize for Token Usage

​Next Steps

Authentication Guide

Chat API Reference

Code Examples

Rate Limits

​Troubleshooting

Get Your API Key

Make Your First Request

Understanding the Response

Common Use Cases

Best Practices

Secure Your API Key

Handle Errors Gracefully

Optimize for Token Usage

Next Steps

Troubleshooting