Skip to main content

POST /v1/audio/translations

Translates audio from a non-English language into English text. The request body must be sent as multipart/form-data with the audio file included as a file field. This endpoint maps to the createTranslation operation and is compatible with the OpenAI Whisper translation API.
This endpoint always produces English output. To transcribe audio without translation, use audio transcriptions instead.

Request headers

string
The provider to route the request to (e.g. openai). Required when not using a config.
string
Your provider API key.
string
A JSON config object or config ID that defines routing, fallbacks, retries, and more.
string
A virtual key ID from Portkey Cloud.

Request body

This endpoint accepts multipart/form-data. The audio file must be uploaded as a file field named file.
file
required
The audio file to translate. Supported formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Maximum file size is 25 MB.
string
required
The speech-to-text model to use (e.g. whisper-1).
string
Optional English text to guide the model’s output style or provide context. The prompt should be in English even if the source audio is in another language.
string
default:"json"
The format of the translation output. One of json, text, srt, verbose_json, or vtt.
number
default:"0"
Sampling temperature between 0 and 1. Higher values produce more varied output.

Response

The response format depends on the response_format parameter. json (default)
string
The translated English text.
verbose_json
string
The full translated text.
string
The detected language of the source audio.
number
The duration of the audio file in seconds.
object[]
Segment-level data for the translation.
text, srt, vtt — Plain-text or subtitle format strings.

Code examples