SONYK API
Your Journey to AI Voice Agents
Visit SONYK
Your journey begins at sonyk.io - the gateway to AI voice agents
# Visit SONYK Platform
🚀 URL: https://sonyk.io
# Welcome to AI Voice Agents
✨ Build intelligent voice assistants
🎯 No coding required
🚀 Go live in minutes
Sign Up / Login
Choose your path: Create new account or sign in to existing one
Verify OTP
Check your email for the 6-digit code and enter it to continue
Generate API Key
Create your first API key to access the SONYK platform
Create AI Agent
Build your first AI voice agent with custom personality and capabilities
POST /api/developer/agents
Headers:
X-API-Key: sonyk_1234567890abcdef1234567890abcdef12345678
Content-Type: application/json
Body:
{
"agent_name": "Restaurant Assistant",
"agent_json": {
"name": "Georgia",
"firstMessage": "Hello! Welcome to Vincenzo Restaurant.",
"llm": {
"model": "gpt-4o-mini",
"provider": "openai",
"systemPrompt": "You are Georgia, a friendly restaurant receptionist.",
"temperature": 0.7,
"maxTokens": 500
},
"tts": {
"model": "Eleven-turbo-v2-5",
"voiceId": "EXAVITQu4vr4xnSDxMaL",
"provider": "elevenlabs"
},
"stt": {
"model": "nova-3",
"provider": "deepgram"
}
}
}
Connect Phone Number
Link a phone number to your agent so users can call and interact
POST /api/developer/phones
Headers:
X-API-Key: sonyk_1234567890abcdef1234567890abcdef12345678
Content-Type: application/json
Body:
{
"phoneNumber": "+1234567890",
"provider": "twilio",
"nickname": "Main Reception Line",
"agentId": "ec2b396d-58e0-96f8-89af-f35908a8b36"
}
Add Knowledge Base
Upload documents and create knowledge assets to make your agent smarter
# Upload File
POST /api/developer/assets/{agentId}/upload
Headers:
X-API-Key: sonyk_1234567890abcdef1234567890abcdef12345678
Content-Type: multipart/form-data
Body:
file=@restaurant-menu.pdf
title="Restaurant Menu 2025"
# Create Text Asset
POST /api/developer/assets/{agentId}/text
Headers:
X-API-Key: sonyk_1234567890abcdef1234567890abcdef12345678
Content-Type: application/json
Body:
{
"title": "Restaurant FAQ",
"text": "# FAQ\n\n## Hours?\nOpen 10AM-11PM daily"
}
Go Live!
Your AI voice agent is ready! Test it by calling your phone number
# 🎉 Success! Your AI Voice Agent is Live!
📞 Phone Number: +1234567890
🤖 Agent: Georgia (Restaurant Assistant)
🎯 Status: Active and Ready
# Test Your Agent
1. Call the phone number
2. Have a conversation with your AI
3. Monitor calls in dashboard
4. Iterate and improve
# Next Steps
- Add more knowledge documents
- Customize voice and personality
- Set up call analytics
- Scale to multiple agents