SDKS

KrosAI provides official SDKs to simplify integration with your applications.

Voice SDK (JavaScript)

Connect WebRTC voice agents to phone numbers with the KrosAI Voice SDK.

Installation

Install (npm)

npm install @krosai/voice-sdk

Quick Start

quickstart.ts

import { KrosAI } from '@krosai/voice-sdk';

const krosai = new KrosAI({ 
  apiKey: 'kros_live_your_key' 
});

// Connect your voice agent to a phone number
const call = await krosai.call({
  phoneNumber: '[phone]',
  audioStream: myAgentAudioStream,
});

// Handle call events
call.on('connected', () => console.log('Call connected'));
call.on('ended', (data) => console.log('Call ended:', data.reason));

// Control the call
call.mute();
call.unmute();
await call.hangup();

Features

• WebRTC to Phone: Connect any WebRTC audio stream to phone calls

• Event Streaming: Real-time call status and audio events

• Audio Controls: Mute, unmute, and volume control

• Low Latency: Sub-second audio transmission

→ Full Voice SDK Documentation

React SDK

React hooks and components for voice integration.

Installation

Install (npm)

npm install @krosai/voice-sdk @krosai/voice-sdk-react

Quick Start

App.tsx

import { KrosAIProvider, useKrosAICall } from '@krosai/voice-sdk-react';

function App() {
  return (
    <KrosAIProvider apiKey="kros_live_your_key">
      <PhoneAgent />
    </KrosAIProvider>
  );
}

function PhoneAgent() {
  const { 
    call, 
    startCall, 
    endCall, 
    status, 
    duration,
    isMuted,
    toggleMute 
  } = useKrosAICall();

  const handleCall = async () => {
    await startCall({
      phoneNumber: '[phone]',
      audioStream: myAgentAudioStream,
    });
  };

  return (
    <div>
      <p>Status: {status}</p>
      <p>Duration: {duration}s</p>
      
      {!call ? (
        <button onClick={handleCall}>Start Call</button>
      ) : (
        <>
          <button onClick={toggleMute}>
            {isMuted ? 'Unmute' : 'Mute'}
          </button>
          <button onClick={endCall}>End Call</button>
        </>
      )}
    </div>
  );
}

Hooks

Hook	Description
useKrosAICall()	Main hook for call management
useAudioLevels(call)	Real-time audio level meters
useKrosAIClient()	Access the raw SDK client

REST API

For server-side integrations, use the REST API directly:

listPhoneNumbers.ts

// TypeScript API Client
async function listPhoneNumbers() {
  const response = await fetch('https://api.krosai.com/v1/phone-numbers', {
    headers: {
      'x-api-key': process.env.KROSAI_API_KEY!,
    },
  });
  return response.json();
}

async function initiateCall(toNumber: string, fromNumber: string, endpointId: string) {
  const response = await fetch('https://api.krosai.com/v1/outbound-calls', {
    method: 'POST',
    headers: {
      'x-api-key': process.env.KROSAI_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      to_number: toNumber,
      from_number: fromNumber,
      endpoint_id: endpointId,
    }),
  });
  return response.json();
}

Python SDK (Coming Soon)

A Python SDK is in development:

preview.py

# Preview - API may change
from krosai import KrosAI

client = KrosAI(api_key='kros_live_your_key')

# List phone numbers
numbers = client.phone_numbers.list()

# Initiate an outbound call
call = client.calls.create(
    from_number='[phone]',
    to_number='[phone]',
    endpoint_id='ep_abc123'
)

print(f'Call initiated: {call.id}')

Interested in early access? Contact us at [email protected]

Community Libraries

Community-maintained libraries (unofficial):

Language	Library	Author
Go	krosai-go	Community
Ruby	krosai-ruby	Community
PHP	krosai-php	Community

Community libraries are not officially supported. Use at your own discretion.

API Rate Limits

SDK requests are subject to rate limits:

Tier	Requests/Second	Requests/Day
Free	10	1,000
Pro	50	50,000
Business	200	500,000
Enterprise	Custom	Custom

Rate limit headers are included in responses:

Rate limit headers

X-RateLimit-Limit: 50
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1704891600

Error Handling

All SDKs use consistent error codes:

error-handling.ts

import { KrosAIError } from '@krosai/voice-sdk';

try {
  await krosai.call({ phoneNumber: 'invalid' });
} catch (error) {
  if (error instanceof KrosAIError) {
    switch (error.code) {
      case 'INVALID_PHONE_NUMBER':
        console.error('Invalid phone format');
        break;
      case 'INSUFFICIENT_BALANCE':
        console.error('Add credits to continue');
        break;
      case 'RATE_LIMIT_EXCEEDED':
        console.error('Slow down requests');
        break;
      default:
        console.error('Unknown error:', error.message);
    }
  }
}