{"openapi":"3.0.0","info":{"description":"Indian language AI platform for speech-to-text, text-to-speech, translation, and chat completion across 22+ Indian languages","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"Indian language AI platform for speech-to-text, text-to-speech, translation, and chat completion across 22+ Indian languages","url":"https://api.apirails.com/sarvam"}],"paths":{"/v1/chat/completions":{"post":{"tags":["Chat"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/chat/chat-completions","api_endpoint":"https://api.sarvam.ai/v1/chat/completions"},"summary":"Chat completions","description":"Generate chat completions with Sarvam multilingual LLMs (Sarvam-30B, Sarvam-105B)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"model":{"type":"string","description":"Model ID (sarvam-30b, sarvam-105b)","required":true},"messages":{"type":"array","description":"Array of message objects","required":true},"temperature":{"type":"number","description":"Sampling temperature (0-2)"},"top_p":{"type":"number","description":"Nucleus sampling parameter"},"max_tokens":{"type":"number","description":"Maximum tokens to generate"},"reasoning_effort":{"type":"string","description":"Reasoning effort level (low, medium, high)"},"wiki_grounding":{"type":"boolean","description":"Enable Wikipedia grounding for factual accuracy"}}},"example":{"model":"","messages":[],"temperature":"","top_p":"","max_tokens":"","reasoning_effort":"","wiki_grounding":""}}}}}},"/speech-to-text":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text/transcribe","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text"},"summary":"Speech to text","description":"Transcribe audio files using Saarika v2.5 model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"audio":{"type":"string","format":"binary","description":"Audio file content","required":true},"model":{"type":"string","description":"Model (saarika:v2.5)","required":true},"language_code":{"type":"string","description":"Language code (hi-IN, ta-IN, etc.)"}}},"example":{"audio":"(binary)","model":"","language_code":""}}}}}},"/speech-to-text-translate":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text-translate/translate","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text-translate"},"summary":"Speech to text translate","description":"Transcribe and translate audio to English using Saaras v3 model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"audio":{"type":"string","format":"binary","description":"Audio file content","required":true},"model":{"type":"string","description":"Model (saaras:v3)","required":true}}},"example":{"audio":"(binary)","model":""}}}}}},"/text-to-speech":{"post":{"tags":["Text-to-Speech"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/text-to-speech/convert","api_endpoint":"https://api.sarvam.ai/v1/text-to-speech"},"summary":"Text to speech","description":"Convert text to speech using Bulbul v3 model","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Text to convert","required":true},"model":{"type":"string","description":"Model (bulbul:v3)","required":true},"language_code":{"type":"string","description":"Language code (hi-IN, ta-IN, etc.)","required":true},"speaker":{"type":"string","description":"Speaker voice ID"},"pitch":{"type":"number","description":"Pitch adjustment"},"pace":{"type":"number","description":"Speech speed"}}},"example":{"text":"","model":"","language_code":"","speaker":"","pitch":"","pace":""}}}}}},"/text-to-speech/stream":{"post":{"tags":["Text-to-Speech"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/text-to-speech/convert-stream","api_endpoint":"https://api.sarvam.ai/v1/text-to-speech/stream"},"summary":"Text to speech stream","description":"Stream text to speech using HTTP streaming","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"text":{"type":"string","description":"Text to convert","required":true},"model":{"type":"string","description":"Model (bulbul:v3)","required":true},"language_code":{"type":"string","description":"Language code","required":true}}},"example":{"text":"","model":"","language_code":""}}}}},"websocket":{"tags":["Text-to-Speech"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/text-to-speech/stream","api_endpoint":"https://api.sarvam.ai/v1/text-to-speech/stream"},"summary":"Stream TTS (WebSocket)","description":"Stream text-to-speech via WebSocket","security":[{"bearerAuth":[]}]}},"/translate":{"post":{"tags":["Text Processing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/text/translate-text","api_endpoint":"https://api.sarvam.ai/v1/text/translate"},"summary":"Translate text","description":"Translate text using Mayura or Sarvam-Translate models","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"input":{"type":"string","description":"Text to translate","required":true},"source_language_code":{"type":"string","description":"Source language code","required":true},"target_language_code":{"type":"string","description":"Target language code","required":true},"model":{"type":"string","description":"Translation model (mayura, sarvam-translate)"}}},"example":{"input":"","source_language_code":"","target_language_code":"","model":""}}}}}},"/transliterate":{"post":{"tags":["Text Processing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/text/transliterate-text","api_endpoint":"https://api.sarvam.ai/v1/text/transliterate"},"summary":"Transliterate text","description":"Transliterate text between scripts","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"input":{"type":"string","description":"Text to transliterate","required":true},"source_language_code":{"type":"string","description":"Source language code","required":true},"target_language_code":{"type":"string","description":"Target language code","required":true}}},"example":{"input":"","source_language_code":"","target_language_code":""}}}}}},"/text-lid":{"post":{"tags":["Text Processing"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/text/identify-language","api_endpoint":"https://api.sarvam.ai/v1/text/identify-language"},"summary":"Identify language","description":"Identify language and script of text","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"input":{"type":"string","description":"Text to analyze","required":true}}},"example":{"input":""}}}}}},"/document-intelligence/init":{"post":{"tags":["Document Intelligence"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/document-intelligence/initialise","api_endpoint":"https://api.sarvam.ai/v1/document-intelligence/init"},"summary":"Init document intelligence job","description":"Initialize a document intelligence job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/document-intelligence/start":{"post":{"tags":["Document Intelligence"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/document-intelligence/start","api_endpoint":"https://api.sarvam.ai/v1/document-intelligence/start"},"summary":"Start document intelligence job","description":"Start a document intelligence job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/document-intelligence/status/{job_id}":{"get":{"tags":["Document Intelligence"],"parameters":[{"name":"job_id","in":"path","description":"Job ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/document-intelligence/get-status","api_endpoint":"https://api.sarvam.ai/v1/document-intelligence/status/{job_id}"},"summary":"Get document job status","description":"Get document intelligence job status","security":[{"bearerAuth":[]}]}},"/speech-to-text/job/init":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text/stt/job/initiate","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text/job/init"},"summary":"Init batch STT job","description":"Initialize batch speech-to-text job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"language_code":{"type":"string","description":"Language code (e.g., hi-IN, ta-IN)"},"model":{"type":"string","description":"Model name (saarika or saaras)"}}},"example":{"language_code":"","model":""}}}}}},"/speech-to-text/job/upload":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text/stt/job/upload","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text/job/upload"},"summary":"Upload files for STT job","description":"Upload files for batch speech-to-text job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/speech-to-text/job/start":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text/stt/job/start","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text/job/start"},"summary":"Start batch STT job","description":"Start batch speech-to-text job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/speech-to-text/job/status":{"get":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text/stt/job/status","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text/job/status"},"summary":"Get batch STT job status","description":"Get batch speech-to-text job status","security":[{"bearerAuth":[]}]}},"/speech-to-text/job/download":{"get":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text/stt/job/download","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text/job/download"},"summary":"Download STT results","description":"Download batch speech-to-text results","security":[{"bearerAuth":[]}]}},"/speech-to-text-translate/job/init":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text-translate/stt-translate/job/initiate","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text-translate/job/init"},"summary":"Init batch STT translate job","description":"Initialize batch speech-to-text translate job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/speech-to-text-translate/job/upload":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text-translate/stt-translate/job/upload","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text-translate/job/upload"},"summary":"Upload files for STT translate job","description":"Upload files for batch speech-to-text translate job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/speech-to-text-translate/job/start":{"post":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text-translate/stt-translate/job/start","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text-translate/job/start"},"summary":"Start batch STT translate job","description":"Start batch speech-to-text translate job","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/speech-to-text-translate/job/status":{"get":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text-translate/stt-translate/job/status","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text-translate/job/status"},"summary":"Get batch STT translate job status","description":"Get batch speech-to-text translate job status","security":[{"bearerAuth":[]}]}},"/speech-to-text-translate/job/download":{"get":{"tags":["Speech-to-Text"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/speech-to-text-translate/stt-translate/job/download","api_endpoint":"https://api.sarvam.ai/v1/speech-to-text-translate/job/download"},"summary":"Download STT translate results","description":"Download batch speech-to-text translate results","security":[{"bearerAuth":[]}]}},"/pronunciation-dictionary":{"post":{"tags":["Text-to-Speech"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/pronunciation-dictionary/create","api_endpoint":"https://api.sarvam.ai/v1/pronunciation-dictionary"},"summary":"Create pronunciation dictionary","description":"Create pronunciation dictionary","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"locale":{"type":"string","description":"Locale code"},"entries":{"type":"object","description":"Pronunciation entries"}}},"example":{"locale":"","entries":{}}}}}},"get":{"tags":["Text-to-Speech"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/pronunciation-dictionary/list","api_endpoint":"https://api.sarvam.ai/v1/pronunciation-dictionary"},"summary":"List pronunciation dictionaries","description":"List pronunciation dictionaries","security":[{"bearerAuth":[]}]}},"/pronunciation-dictionary/{id}":{"get":{"tags":["Text-to-Speech"],"parameters":[{"name":"id","in":"path","description":"Dictionary ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/pronunciation-dictionary/get","api_endpoint":"https://api.sarvam.ai/v1/pronunciation-dictionary/{id}"},"summary":"Get pronunciation dictionary","description":"Get pronunciation dictionary by ID","security":[{"bearerAuth":[]}]},"put":{"tags":["Text-to-Speech"],"parameters":[{"name":"id","in":"path","description":"Dictionary ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/pronunciation-dictionary/update","api_endpoint":"https://api.sarvam.ai/v1/pronunciation-dictionary/{id}"},"summary":"Update pronunciation dictionary","description":"Update pronunciation dictionary","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"entries":{"type":"object","description":"Pronunciation entries"}}},"example":{"entries":{}}}}}},"delete":{"tags":["Text-to-Speech"],"parameters":[{"name":"id","in":"path","description":"Dictionary ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/pronunciation-dictionary/delete","api_endpoint":"https://api.sarvam.ai/v1/pronunciation-dictionary/{id}"},"summary":"Delete pronunciation dictionary","description":"Delete pronunciation dictionary","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/document-intelligence/get-upload-links":{"post":{"tags":["Document Intelligence"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://docs.sarvam.ai/api-reference-docs/document-intelligence/get-upload-links","api_endpoint":"https://api.sarvam.ai/v1/document-intelligence/get-upload-links"},"summary":"Get document upload URLs","description":"Get document upload URLs","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file_count":{"type":"number","description":"Number of files to upload","required":true}}},"example":{"file_count":""}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}