音频Audio
了解如何将音频转换为文本。
相关指南:语音转文本
创建转录 Create transcription Beta
post https://api.openai.com/v1/audio/transcriptions (opens in a new tab)
将音频转录为输入语言。
请求正文
file
是字符串类型的必填项,表示要转录的音频文件,格式为 mp3
、mp4
、mpeg
、mpga
、m4a
、wav
或 webm
之一。
model
是字符串类型的必填项,表示要使用的模型的ID。目前只有 whisper-1
可用。
prompt
是字符串类型的可选项,用于指导模型的风格或继续以前的音频片段。提示应与音频语言匹配。
response_format
是字符串类型的可选项。默认为 json
。表示转录输出的格式,可选项为 json
、text
、srt
、verbose_json
或 vtt
中的一种。
temperature
是数字类型的可选项。默认为 0。取值范围在 0 到 1 之间。更高的值,如 0.8,会使输出更加随机化,而更低的值,如 0.2,则会使其更加集中和确定性。如果设置为 0,则模型将使用 对数概率 (opens in a new tab) 自动增加温度(temperature),直到触发某些阈值。
language
是字符串类型的可选项,表示输入音频的语言。以 ISO-639-1 (opens in a new tab) 格式提供输入语言将改善准确性和延迟。
请求示例(Python方式)
curl https://api.openai.com/v1/audio/transcriptions
-H "Authorization: Bearer $OPENAI_API_KEY"
-H "Content-Type: multipart/form-data"
-F file="@/path/to/file/audio.mp3"
-F model="whisper-1"
请求参数(Parameters)
{
"file": "audio.mp3",
"model": "whisper-1"
}
响应体 (Response)
{
"text": "Imagine the wildest idea that you've ever had, and you're curious about how it might scale to something that's a 100, a 1,000 times bigger. This is a place where you can get to do that."
}
新建音频翻译 Create translation Beta
post https://api.openai.com/v1/audio/translations (opens in a new tab)
将音频翻译成英语。
请求体
file
字符串类型,必填项。要翻译的音频文件,格式可以是 mp3、mp4、mpeg、mpga、m4a、wav 或 webm 之一。
model
字符串类型,必填项。要使用的模型 ID。目前只有 whisper-1
可用。
prompt
字符串类型,可选。一个可选的文本,用于指导模型的风格或继续前面的音频片段。提示应为英语。
response_format
字符串类型,可选。默认是 json
。转录输出的格式,可以是 json、文本、srt、verbose_json 或 vtt 中的一种。
temperature
数字类型,可选。默认是 0。采样温度(temperature),介于 0 和 1 之间。较高的值如 0.8 将使输出更加随机,而较低的值如 0.2 将使其更加聚焦和确定性。如果设置为 0,则模型将使用对数概率 (opens in a new tab)自动增加温度(temperature),直到达到某些阈值。
请求示例(Python方式)
curl https://api.openai.com/v1/audio/translations
-H "Authorization: Bearer $OPENAI_API_KEY"
-H "Content-Type: multipart/form-data"
-F file="@/path/to/file/german.m4a"
-F model="whisper-1"
请求参数(Parameters)
{
"file": "german.m4a",
"model": "whisper-1"
}
响应体 (Response)
{
"text": "Hello, my name is Wolfgang and I come from Germany. Where are you heading today?"
}