语音转文本
语音转文本
将输入的语音转为文字。
请求方式
POST
调用地址
https://api-${endpoint}.gptbots.ai/v1/audio-to-text
调用验证
详情参见 API 概述的鉴权方式说明。
请求
请求示例
curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/audio-to-text' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: multipart/form-data' \
-F 'file=@/Users/liujishi/Desktop/1.mp3'
curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/audio-to-text' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: multipart/form-data' \
-F 'file=@/Users/liujishi/Desktop/1.mp3'
此代码块在浮窗中显示
请求头
| 字段 | 类型 | 描述 |
|---|---|---|
| Authorization | Bearer ${API Key} | 使用 Authorization: Bearer ${API Key}进行调用验证，请在 API 密钥页面获取密钥作为 API Key。 |
| Content-Type | multipart/form-data | 数据类型，取值为 multipart/form-data。 |
请求体
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
| file | Byte[] | 是 | 语音文件，最多 25 MB，支持的文件格式：mp3 |
响应
响应示例
{
"text": "Hi, is there anything I can help you?"
}
{
"text": "Hi, is there anything I can help you?"
}
此代码块在浮窗中显示
成功响应
| 字段 | 类型 | 描述 |
|---|---|---|
| text | string | 识别的文本内容。 |
失败响应
| 字段 | 类型 | 描述 |
|---|---|---|
| code | int | 错误码。 |
| message | string | 错误详情。 |
错误码
| Code | Message |
|---|---|
| 40000 | 参数错误 |
| 40127 | 开发者鉴权失败 |
| 40325 | 文件类型无效，仅支持‘m4a’，‘mp3’，‘webm’，‘mp4’，‘mpga’，‘wav’，‘mpeg’ |
| 50000 | 系统内部错误 |
| 200116 | 多模态语音输入功能未开启 |
| 40353 | 升级套餐后才支持使用该功能 |
| 40326 | 文件大小不能超过 25MB |
| 20059 | Agent 已删除 |
| 20022 | 积分不足 |