POST
/
audio
/
translations
Create translation
curl --request POST \
  --url https://api.openai.com/v1/audio/translations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form model=whisper-1 \
  --form 'prompt=<string>' \
  --form response_format=json \
  --form temperature=0 \
  --form file=@example-file
{
  "text": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
​
file
file
required

The audio file object (not file name) translate, in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.

​
model
required

ID of the model to use. Only whisper-1 (which is powered by our open source Whisper V2 model) is currently available.

Example:

"whisper-1"

​
prompt
string

An optional text to guide the model's style or continue a previous audio segment. The prompt should be in English.

​
response_format
enum<string>
default:json

The format of the output, in one of these options: json, text, srt, verbose_json, or vtt.

Available options:
json,
text,
srt,
verbose_json,
vtt
​
temperature
number
default:0

The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use log probability to automatically increase the temperature until certain thresholds are hit.

Response

200 - application/json

OK

​
text
string
required