Translation

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

Request format

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()

Response format

The API returns a translation of the input audio in the selected format.

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.

Overview

Inference API

Using the API

Endpoint

Request parameters

Whisper Large v3

Request format

CURL

Python

Response format

JSON

Text

​Endpoint

​Request parameters

​Whisper Large v3

​Request format

​CURL

​Python

​Response format

​JSON

​Text

Endpoint

Request parameters

Whisper Large v3

Request format

CURL

Python

Response format

JSON

Text