メインコンテンツへスキップ
POST
cURL

承認

Authorization
string
header
必須

すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401unauthorized)で失敗します。

ボディ

multipart/form-data

音声からテキストへの変換のリクエストボディ。

file
file
必須

文字起こしする音声ファイルです。受け付ける MIME タイプは audio/mp3audio/m4aaudio/wavaudio/amraudio/mpga です。それ以外のタイプ(一般的な audio/mpeg を含む)は unsupported_audio_type で拒否されます。最大サイズは 30 MB です。

user
string

エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。エンドユーザーの識別 を参照してください。

レスポンス

音声からテキストへの変換に成功しました。

text
string

音声認識からの出力テキスト。