Skip to main content

音声認識バッチの作成

POST 
/v2/batch-recognitions

音声ファイルの URL 一覧を指定して、音声認識バッチを作成します。

JSON 形式と multipart/form-data 形式を利用できます。JSON 形式では files 配列に URL を指定します。multipart/form-data 形式では、音声ファイル一覧を JSON 配列文字列として a に指定します。Content-Type を省略した場合や application/*+json を指定した場合も、JSON として処理します。

API キーは Authorization: Bearer {APIキー} ヘッダー、d 内の authorization=\{APIキー\}、または multipart/form-data の u のいずれかで必ず指定してください。複数の場所に指定した場合、空でない API キーはすべて一致する必要があります。一致しない場合は HTTP 401 を返します。

各ファイルの URL と content_id を個別に確認し、すべて有効な場合は HTTP 202、1 件でも無効な場合は HTTP 207 を返します。無効なファイルがあっても、有効なファイルの処理は続行します。すべて無効な場合も HTTP 207 を返します。受付後のダウンロードと音声認識は非同期で行うため、作成時の session_id はすべて null です。

d にエンジンモードの指定がない場合は、バッチを作成せず、HTTP 200 と code: "-" を含むエラーレスポンスを返します。この確認は、API キーが有効かどうかの確認より先に行います。ただし、API キーの未指定、Authorization ヘッダーの形式の誤り、複数の場所の API キーの不一致は、先に HTTP 401 を返します。

Request​

Responses​

d にエンジンモードの指定がないため、バッチを作成できませんでした。