Choose Your Path

// Complete chat setup in 3 lines
import { AnimusClient } from 'animus-client';
const client = new AnimusClient({ tokenProviderUrl: 'your-auth-server' });
client.on('messageComplete', (data) => console.log('Friend:', data.content));
client.chat.send('Hey, how has your day been?');

# Python example with requests
import requests

response = requests.post('https://api.animusai.co/v3/chat/completions', 
  headers={'Authorization': 'Bearer your-api-key'},
  json={
    'model': 'vivian-llama3.1-70b-1.0-fp8',
    'messages': [{'role': 'user', 'content': 'Hello!'}]
  })

// Natural conversation with automatic history
client.on('messageComplete', (data) => updateChatUI(data.content));
client.chat.send(userInput);

// Streaming responses with events
const stream = await client.chat.completions({ stream: true });
for await (const chunk of stream) {
  updateUI(chunk.choices[0].delta.content);
}

// Automatic image generation
client.on('imageGenerationComplete', (data) => displayImage(data.imageUrl));
client.chat.send('I need some inspiration today, could you create something beautiful?');

// Conversational turns with natural delays
const client = new AnimusClient({
  chat: {
    systemMessage: 'You are a caring companion.',
    autoTurn: true // Natural conversation flow
  }
});

# Generate multiple response options for human selection
response = requests.post(api_url, json={
    'model': 'vivian-llama3.1-70b-1.0-fp8',
    'messages': [{'role': 'user', 'content': user_message}],
    'n': 3,  # Generate 3 response options
    'temperature': 0.8  # Add variety between responses
})

# Extract all response options
response_options = [choice['message']['content'] for choice in response.json()['choices']]
# Present options to human for selection
best_response = human_select_best(response_options)

# Batch video analysis and categorization
video_batch = ['frame1.jpg', 'frame2.jpg', 'frame3.jpg']
for frame in video_batch:
    response = requests.post(api_url, json={
        'model': 'xavier-vision-1.0',
        'messages': [{
            'role': 'user',
            'content': [
                {'type': 'text', 'text': 'Categorize this video frame and provide a description'},
                {'type': 'image_url', 'image_url': {'url': f'data:image/jpeg;base64,{encode_image(frame)}'}}
            ]
        }]
    })
    video_analysis.append(response.json())

# Analyze conversation patterns and build speaker profiles
conversation_history = load_chat_history(user_id)
analysis = requests.post(api_url, json={
    'model': 'vivian-llama3.1-70b-1.0-fp8',
    'messages': [{
        'role': 'user', 
        'content': f'Analyze this conversation and create personality profiles for both speakers: {conversation_history}'
    }]
})
speaker_profiles = analysis.json()['choices'][0]['message']['content']

// Automatic token management
const client = new AnimusClient({
  tokenProviderUrl: 'http://localhost:3001/token' // Your secure backend
});
// SDK handles token refresh automatically

# Manual token management
headers = {'Authorization': f'Bearer {api_key}'}
response = requests.post(url, headers=headers, json=data)

// Clean AsyncIterable pattern
const stream = await client.chat.completions({ stream: true });
for await (const chunk of stream) {
  console.log(chunk.choices[0].delta.content);
}

# Manual SSE parsing
response = requests.post(url, stream=True)
for line in response.iter_lines():
    if line.startswith(b'data: '):
        chunk = json.loads(line[6:])
        print(chunk['choices'][0]['delta']['content'])

// Specific error types
try {
  // Event-driven approach
  client.chat.send('Hello');
  
  // Or use completions() for direct API calls
  const response = await client.chat.completions({
    messages: [{ role: 'user', content: 'Hello' }]
  });
} catch (error) {
  if (error instanceof AuthenticationError) {
    // Handle auth issues
  } else if (error instanceof ApiError) {
    // Handle API errors
  }
}

# HTTP status code handling
try:
    response = requests.post(url, json=data)
    response.raise_for_status()
except requests.exceptions.HTTPError as e:
    if e.response.status_code == 401:
        # Handle auth error
    elif e.response.status_code == 429:
        # Handle rate limit