8. 感情認識

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

Step1 : 事前準備

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

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

  • 参考:感情認識サービスの URI
    • https://apis.mimi.fd.ai/auth/emo-categorical/http-api-service
    • https://apis.mimi.fd.ai/auth/emo-categorical/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:emo-categorical" \
-H "Authorization: Bearer <accessToken>" \
--data-binary @/path/to/audio.raw

応答例

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

{
  "type": "emo#categorial",
  "session_id": "b758067a-2b33-11ec-8865-42010a92003c",
  "status": "recog-finished",
  "response": {
    "scores": {
      "neutral": 0.6329927786316619,
      "happiness": 0.00023493017127678665,
      "sadness": 0.3173239610473178,
      "anger": 0.0005972573319338948,
      "disgust": 0.048851056812642006
    },
    "interval": {
      "start": 0,
      "end": 6271
    },
    "label": "neutral"
  }
}

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