# 创建翻译(whisper

**方法**: `POST`
**路径**: `/v1/audio/translations`

要翻译的音频文件对象(不是文件名),格式为:flac、mp3、mp4、mpeg、mpga、m4a、ogg、wav 或 webm。

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 multipart/form-data

```text
file
file
必需
要翻译的音频文件对象(不是文件名),格式为:flac、mp3、mp4、mpeg、mpga、m4a、ogg、wav 或 webm。
model
string
必需
要使用的模型 ID。目前只有 whisper-1 是可用的。
prompt
string
可选
一个可选的文本,用于指导模型的风格或继续之前的音频段落。提示文本应该是英文。
response_format
string
可选
翻译结果的格式,可选择:json、text、srt、verbose_json 或 vtt。
temperature
number
可选
默认为 0
采样温度,介于 0 和 1 之间。更高的值如 0.8 会使输出更随机,而较低的值如 0.2 会使其更聚焦和确定性。如果设置为 0,模型将使用对数概率自动提高温度直到达到特定阈值。
```

## 请求示例代码

### Shell

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

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
text
string
必需
```

#### 示例

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