語音轉換為文字
語音轉換為文字
將音訊內容轉換為文字形式。
請求方法
POST
請求 URL
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=@/path/to/your/audio/file.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=@/path/to/your/audio/file.mp3'
此代碼塊在浮窗中顯示
請求標頭
| 欄位 | 類型 | 描述 |
|---|---|---|
| Authorization | Bearer ${API Key} | 使用 Authorization: Bearer ${API Key} 完成認證。API Key 可從 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 | 錯誤詳情。 |
錯誤代碼
| 錯誤代碼 | 錯誤訊息 |
|---|---|
| 40000 | 參數無效 |
| 40127 | 開發者認證失敗 |
| 40325 | 無效的檔案類型，僅支援 'm4a'、'mp3'、'webm'、'mp4'、'mpga'、'wav'、'mpeg' |
| 50000 | 內部伺服器錯誤 |
| 20059 | Agent 已刪除 |
| 200116 | 未開啟多模態語音輸入功能 |
| 40353 | 僅在升級套餐後可用 |
| 40326 | 限制為 25 MB |
| 20059 | bot 已刪除 |
| 20022 | 帳戶點數不足 |