ジョブの作成
POST/v2/recognitions
音声認識ジョブを作成します。
v1(従来版)について
従来版のジョブ作成エンドポイントは POST https://acp-api-async.amivoice.com/v1/recognitions です。リクエスト・レスポンスの形式は v2 と同じです。v1 は今後停止される予定のため、ご利用中の方は v2 への移行を行ってください。ただし、v2 では現在、感情分析の機能を利用できません。感情分析を利用する場合は v1 をご利用ください。
注意
- 音声データ以外はクエリパラメータでもマルチパートでも送信することができます。クエリパラメータに d パラメータを設定するとリクエストラインの上限を超える可能性があるため、マルチパートで送信することを推奨します。
- クエリパラメータとマルチパートの両方に同じパラメータが指定されている場合、クエリパラメータに設定した値が優先されます。
リクエスト
レスポンス
- 200
成功時のレスポンスは JSON フォーマットで以下の値を持ちます。
| キー | 説明 |
|---|---|
| sessionid | ユーザーの音声認識リクエストに対するジョブの ID。ジョブの状態の確認、結果の取得の際に使います。 |
| text | 常に...を返します。 |
失敗時のレスポンスは JSON フォーマットで results、text、code、message を持ちます。code、message についてはレスポンスコードとメッセージを参照してください。