Skip to main content

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 least 120s.
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.
For 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.