Skip to main content
The SvaraAI API provides endpoints for emotion analysis, AI-powered conversation responses, and conversation management. All endpoints use JSON for request and response bodies.

​
Base URL

The API runs on port 5000 by default: 
http://localhost:5000/api

​
Authentication

Currently, the API does not require authentication for local development. Production deployments should implement appropriate authentication mechanisms.

​
Available endpoints

Hume endpoint

Analyze audio for emotional content using Hume AI

Gemini endpoint

Generate AI responses based on transcript and emotion data

Entries endpoint

Save and manage conversation entries

​
Error handling

All endpoints return standard HTTP status codes:
  • 200 - Success
  • 400 - Bad request (missing or invalid parameters)
  • 500 - Server error
Error responses follow this format: 
{
  "error": "Error message describing what went wrong"
}

​
Content type

All requests should include the Content-Type: application/json header. The API returns JSON responses for all endpoints.

​
CORS

CORS is enabled for all origins in development. Configure appropriate CORS settings for production deployments.

Build docs developers (and LLMs) love

Get started for freeTalk to us