Overview
Translates audio in any supported language into English text. Unlike transcription, this endpoint always outputs English text regardless of the input language.This page documents audio translation (
POST /v1/audio/translations). For text translation, use POST /v1/translations.Do not use
recommended_for=translation for this endpoint. That recommendation scene is reserved for text translation models on POST /v1/translations.Request Body
Synchronous request timeout: This non-chat endpoint waits for the routed model to finish. Large inputs, long audio, or large batches can exceed common 30s client defaults, so set your HTTP client timeout to at least120s.
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
default:"whisper-1"
The model to use. Currently only
whisper-1 is supported.string
An optional text to guide the model’s style or continue a previous segment. Should be in English.
string
default:"json"
The format of the output. Options:
json, text, srt, verbose_json, vtt.number
The sampling temperature, between 0 and 1. Higher values like 0.8 produce more random output, while lower values like 0.2 make output more focused and deterministic.
Response
string
The translated text in English.
verbose_json format, the response also includes:
string
The detected language of the input audio.
number
The duration of the input audio in seconds.
array
Segments of the translated text with timestamps.
Translation vs Transcription
The translation endpoint automatically detects the source language and translates to English. The
language parameter from transcription is ignored.