API reference

Translations

POST

/v1/audio/translations

Last modified:2025-02-05 11:13:28

将音频翻译成英文。

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Content-Type

string

required

Example:

multipart/form-data

string

required

Example:

application/json

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params multipart/form-data

file

required

要翻译的音频文件，支持以下格式：mp3，mp4，mpeg，mpga，m4a，wav 或 webm。

model

string

required

(要使用的模型的 ID，目前仅有 whisper-1 可用。

Example:

whisper-1

prompt

string

optional

一个可选的文本，用于指导模型的风格或继续先前的音频片段。 prompt 应为英文。

response_format

string

optional

转录输出的格式，支持以下选项之一：json、text、srt、verbose_json 或 vtt。

Example:

json

temperature

number

optional

采样温度，介于 0 和 1 之间。较高的值（如 0.8）将使输出更随机，而较低的值（如 0.2）将使其更加专注和确定性。如果设置为 0，则模型将使用对数概率自动增加温度，直到达到一定的阈值。

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/v1/audio/translations' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'Authorization;' \
--header 'Content-Type: multipart/form-data' \
--form 'file=@""' \
--form 'model="whisper-1"' \
--form 'prompt=""' \
--form 'response_format="json"' \
--form 'temperature="0"'

Responses

🟢200OK

application/json

Body

text

string

required

Example

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

Transcriptions

Speech