スタートガイドAPI Reference
mimi API ConsoleGitHub

7. 態度認識

mimi AIR のスタートガイドです。
mimi の態度認識サービスを利用できるようになるまでの手順をまとめています。

Suggest Edits

Step1 : 事前準備

1. アクセストークンの取得

1. トークンの取得を実行して、アクセストークンを取得してください。この際、態度認識サービスが実行できるようスコープの指定を行い、アクセストークンを払い出すよう注意して下さい。

  • 参考：態度認識サービスの URI
    • https://apis.mimi.fd.ai/auth/air/http-api-service
    • https://apis.mimi.fd.ai/auth/air/websocket-api-service

2. 態度認識用のサンプルファイルの取得

以下のURLにアクセスし、サンプル音声を取得してください。

https://github.com/FairyDevicesRD/mimi.example.ruby/raw/master/audio.raw

Step2 : 態度認識サービスの実行

アクセストークンを発行したら、態度認識サービスを実行することができます。
識別対象言語は日本語のみです。

以下は、 cURL コマンドを利用したHTTPリクエストの実行例と応答例です。

📘

ポイント

cURL リクエストで 音声ファイルを指定する場合、先頭に@をつけることが必要です。
@ をつけずにリクエスト実行してもファイルが読み込まれないため内容は送信されず、空（''）応答になりますのでご注意ください。

実行例

curl -X POST https://service.mimi.fd.ai \
-H "Content-Type: audio/x-pcm;bit=16;rate=16000;channels=1" \
-H "x-mimi-process:air" \
-H "Authorization: Bearer <accessToken>" \
--data-binary @/path/to/audio.raw

応答例

態度認識が正常に実行できた場合、結果は JSON で返ってきます。

{
  "type": "air",
  "session_id": "e4279e88-e48c-11eb-b7db-42010a92008e",
  "status": "recog-finished",
  "response": {
    "time_interval": {
      "start": 0,
      "end": 6270
    },
    "label": "agreement",
    "scores": {
      "question": 0.00122833251953125,
      "stalling": 0.0003516674041748047,
      "agreement": 0.99853515625,
      "disagreement": 1.7881393432617188e-06
    }
  }
}

態度認識の詳細については mimi AIR のドキュメント および API Reference を参照ください。

Updated 6 months ago