非同期 HTTP インタフェース

非同期 HTTP インタフェースは長時間の音声をテキスト化、文字起こしするためのノンブロッキングな HTTP API です。

この API を利用するには以下のステップを実行します。

1. 音声認識ジョブを作成する
2. ポーリングして音声認識ジョブの状態をチェックし、結果を取得する

1 のジョブを生成する方法は、ログのあり・なしの指定方法などが異なりますが、同期 HTTP インタフェースとほぼ同じです。

エンドポイント

同期 HTTP インタフェースとは異なり、ログ保存のあり、なしに関わらずエンドポイントのベースは同じです。

v2（新版）

https://acp-api-async.amivoice.com/v2/recognitions

v1（従来版）

https://acp-api-async.amivoice.com/v1/recognitions

v1 と v2 の違いについては、新しいバージョンについてを参照してください。

注意

• 古いバージョンの非同期 HTTP インタフェースは、今後停止される予定です。ご利用中の方は、v2 への移行を行ってください。
• v2 では現在、感情分析の機能を利用することができません。感情分析を利用する場合は、v1 をご利用ください。

認証

以下のいずれかの方法でAPIキーを指定してください。取得方法はAPI キーの発行方法を参照してください。

HTTP リクエストヘッダー

Authorization: Bearer {APIキー}

ジョブの作成では、リクエストパラメータ（u パラメータ）での設定も可能です。

u={APIキー}