Translates audio content to a specified language.
Endpoint
POST https://api.sambanova.ai/v1/audio/translations
For SambaStack, developers should check with their system administrator for the correct URL.
Request parameters
The following tables outline the parameters required to make an audio translation request, parameter type, description, and default values.
For improved accuracy, we strongly recommend specifying the language parameter when using any audio model.
Whisper Large v3
| Parameter | Type | Description | Default |
|---|
model | String | The ID of the model to use. | Required |
file | File | Audio file in FLAC, MP3, MP4, MPEG, MPGA, M4A, Ogg, WAV, or WebM format. File size limit is 25MB. | Required |
prompt | String | Prompt provided to influence translation style or vocabulary. Example: “Please translate carefully, including pauses and hesitations.” | Optional |
response_format | String | Output format: JSON or text. | json |
language | String | The language of the input audio. Supplying the input language in ISO-639-1 (e.g. en) format will improve accuracy and latency. | Optional |
stream | Boolean | Enables streaming responses. | false |
stream_options | Object | Additional streaming configuration (e.g., {"include_usage": true}). | Optional |
This section provides examples of how to send a request using different methods.
CURL
curl --location 'https://api.sambanova.ai/v1/audio/translations' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form 'model="Whisper-Large-v3"' \
--form 'language="spanish"' \
--form 'response_format="json"' \
--form 'file=@"/path/to/audio/file.mp3"' \
--form 'stream="true"'
Python
import requests
def translate_audio(audio_file_path, api_key, target_language="spanish"):
headers = {"Authorization": f"Bearer {api_key}"}
files = {'file': open(audio_file_path, 'rb')}
data = {
'model': 'Whisper-Large-v3',
'language': target_language,
'response_format': 'json',
'stream': True # Optional
}
response = requests.post(
"https://api.sambanova.ai/v1/audio/translations",
headers=headers,
files=files,
data=data
)
return response.json()
JSON
{
"text": "Es un efecto de sonido de una campana sonando, específicamente una campana de iglesia."
}
Text
Es un efecto de sonido de una campana sonando, específicamente una campana de iglesia.
