Audio

Text-to-Speech

client.audio.synthesize sends POST /v1/audio/speech and returns raw audio bytes.

1 from meshapi import MeshAPI, SpeechParams
2 
3 client = MeshAPI(base_url="https://api.meshapi.ai", token="rsk_...")
4 
5 audio_bytes = client.audio.synthesize(
6     SpeechParams(
7         input="Hello from MeshAPI.",
8         model="sarvam/bulbul:v2",
9         voice="meera",
10     )
11 )
12 
13 with open("output.wav", "wb") as f:
14     f.write(audio_bytes)

Async

1 from meshapi import AsyncMeshAPI, SpeechParams
2 
3 async with AsyncMeshAPI(base_url="https://api.meshapi.ai", token="rsk_...") as client:
4     audio_bytes = await client.audio.synthesize(
5         SpeechParams(
6             input="Hello from MeshAPI.",
7             model="sarvam/bulbul:v2",
8         )
9     )

`SpeechParams` fields

Field	Type	Notes
`input`	`str`	Required. Text to synthesize.
`model`	`str`	Required. e.g. `"sarvam/bulbul:v2"`
`voice`	`str \| None`	Voice ID or name
`response_format`	`str \| None`	Audio format, e.g. `"wav"`, `"mp3"`
`speed`	`float \| None`	Playback speed multiplier

Speech-to-Text (Transcription)

client.audio.transcribe sends POST /v1/audio/transcriptions as a multipart upload and returns a TranscriptionResponse.

1 from meshapi import TranscriptionParams
2 
3 with open("audio.wav", "rb") as f:
4     file_bytes = f.read()
5 
6 result = client.audio.transcribe(
7     TranscriptionParams(
8         model="sarvam/saaras:v3",
9         file=file_bytes,
10         file_name="audio.wav",
11         language="en",
12     )
13 )
14 
15 print(result.text)

`TranscriptionParams` key fields

Field	Type	Notes
`model`	`str`	Required. e.g. `"sarvam/saaras:v3"`
`file`	`bytes`	Required. Audio file bytes.
`file_name`	`str`	Required. Filename with extension.
`language`	`str \| None`	Language code, e.g. `"en"`
`keyterms`	`list[str] \| None`	Domain-specific terms to boost recognition
`diarize`	`bool \| None`	Enable speaker diarization
`num_speakers`	`int \| None`	Expected number of speakers
`with_timestamps`	`bool \| None`	Include word-level timestamps

Translation

client.audio.translate sends POST /v1/audio/transcriptions/translate and returns the audio transcribed and translated to English.

1 from meshapi import TranscriptionTranslateParams
2 
3 with open("audio.wav", "rb") as f:
4     file_bytes = f.read()
5 
6 result = client.audio.translate(
7     TranscriptionTranslateParams(
8         model="sarvam/saaras:v3",
9         file=file_bytes,
10         file_name="audio.wav",
11     )
12 )
13 
14 print(result.text)

List Voices

client.audio.list_voices sends GET /v1/audio/voices.

1 from meshapi import ListVoicesParams
2 
3 voices = client.audio.list_voices(ListVoicesParams(page_size=10))
4 print(voices)

`ListVoicesParams` fields

Field	Type	Notes
`page_size`	`int \| None`	Results per page
`next_page_token`	`str \| None`	Pagination cursor
`search`	`str \| None`	Filter by name
`voice_type`	`str \| None`	`"standard"`, `"cloned"`, etc.
`category`	`str \| None`	Voice category filter

Get Voice

client.audio.get_voice sends GET /v1/audio/voices/{voice_id}.

1 voice = client.audio.get_voice("voice-id")
2 print(voice)