音声をテキストへ変換
音声をテキストへ変換
認証方法の説明についてはAPI Overviewをご参照ください。
リクエストメソッド
POST
リクエストURL
https://api-${endpoint}.gptbots.ai/v1/audio-to-text
リクエスト認証
認証の詳細は「概要」セクションをご参照ください。
リクエスト
リクエスト例
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キーページから取得できます。 |
| Content-Type | multipart/form-data | データ形式、multipart/form-dataに設定してください。 |
リクエストボディ
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
| file | Byte[] | 必須 | 音声ファイル（最大25MB）。対応形式：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 | エージェントが削除されました |
| 200116 | マルチモーダル音声入力機能が有効になっていません |
| 40353 | パッケージをアップグレード後に利用可能です |
| 40326 | ファイルサイズは25MBまでです |
| 20059 | ボットが削除されました |
| 20022 | クレジットが不足しています |