Translations

POST

{{BASE_URL}}/v1/audio/translations

Translate the audio into English.

Request

Header Params

Authorization

string

required

Provide your bearer token in the Authorization header when making requests to protected resources.
Example:
Authorization: Bearer ********************

Example:

Bearer {{YOUR_API_KEY}}

Body Params multipart/form-data

file

required

The audio file object to be translated (not the file name) is in the format of flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm.

model

string

required

The model ID to be used. Currently, only Whisper-1 is available.

prompt

string

optional

An optional text used to guide the style of the model or continue with the previous audio paragraph. The prompt text should be in English.

response_format

string

optional

The format of the translation result can be selected as JSON, Text, SRT, Verbose_JSON, or VTT.

temperature

number

optional

Default is 0
Sampling temperature, between 0 and 1. A higher value such as 0.8 will make the output more random, while a lower value such as 0.2 will make it more focused and deterministic. If set to 0, the model will automatically increase the temperature using logarithmic probability until a specific threshold is reached.

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '{{BASE_URL}}/v1/audio/translations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'file=@""' \
--form 'model=""' \
--form 'prompt=""' \
--form 'response_format=""' \
--form 'temperature=""'

Responses

🟢200成功

application/json

Body

text

string

required

Example

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you heading today?"
}

Transcriptions

Embeddings