POST /v1/audio/translations
Translates audio from a non-English language into English text. The request body must be sent asmultipart/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 theresponse_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.