感情認識を行う

🚧

感情認識は本サイト上では実行できないため、mimi API Console にログインいただき、こちら からデモをお試しください。

📘

mimi が定義するカスタム HTTP ヘッダ

mimi が定義するカスタム HTTP ヘッダ( x-mimi- で始まるヘッダ ) に設定する値は、大文字小文字を区別しています。例えば "x-mimi-process" の値に "emo-categorical" は指定できますが、 "EMO-CATEGORICAL" は指定できません。
また、同じヘッダが同一のリクエスト内で複数行指定された場合は、いずれか一つのみが有効になりますので極力 1 種類 1 行となるように指定してください。

API実行に必要なスコープ

HTTP / WebSocket どちらを利用するかによって必要なスコープは変わります。

https://apis.mimi.fd.ai/auth/emo-categorical/http-api-service
https://apis.mimi.fd.ai/auth/emo-categorical/websocket-api-service

実行

HTTP リクエスト実行例は本ページ右の "REQUEST" を参照ください。

応答

応答例

本ページの応答例( 画面右 "RESPONSE" で "200 - Result" を選択)を参照ください。

応答結果 JSON

各要素の型は本ページの "RESPONSE" を参照ください。
( resonse ステータス "200" をクリック)

キー内容
type固定値 emo-categorical
session_idセッションID
status感情認識結果のステータス。
・recog-in-progress=認識処理中
・recog-finished=認識処理終了
response感情認識結果の配列
    interval入力音声中で感情認識の対象となった区間の開始・終了時間。

開始・終了時間は、入力音声の先頭を基準としてミリ秒単位で表される。
        start感情認識の対象となった区間の開始時間 (ミリ秒)
        end感情認識の対象となった区間の終了時間 (ミリ秒)
    label感情認識結果ラベル(スコアが大きかった感情クラスのラベル)
    scores感情認識結果のスコアの配列
        neutral平静クラスのスコア。大きいほど確度が高い。
        happiness喜びクラスのスコア。大きいほど確度が高い。
        sadness悲しみクラスのスコア。大きいほど確度が高い。
        anger怒りクラスのスコア。大きいほど確度が高い。
        disgust嫌悪クラスのスコア。大きいほど確度が高い。
Form Data
string
required
Defaults to @<音声データファイルのフルパス>

音声データファイルは Content-Type の指定と合致している必要がある。cURL リクエスト実行時には先頭に @ をつけなければ送信できないことに留意。

Headers
string
required
Defaults to OAuth2 準拠の Bearer トークンとして発行された mimi のアクセストークン。実行したいサービスに対応するスコープを指定して発行したアクセストークンが必要。アクセストークンの取得方法についてはトークンの取得を参照。

OAuth2 準拠の Bearer トークンとして発行された mimi のアクセストークン。実行したいサービスに対応するスコープを指定して発行したアクセストークンが必要。アクセストークンの取得方法についてはトークンの取得 または 認証/認可操作を参照。

string
required
Defaults to audio/x-pcm;bit=16;rate=16000;channels=1

音声データフォーマット。ヘッダなしリニアPCM( x-pcm )かFLAC( x-flac )のいずれかで指定。audio/x-pcm;bit=16;rate=(整数†);channels=1 または audio/x-flac または audio/x-flac;rate=(整数†) 。いずれの場合も、音声の形式は 符号付き整数(16bit リトルエンディアン), 1ch である必要がある。 † rate= に続く部分には 16000 や 48000 などのサンプリングレートを整数で指定する。サンプリングレートが 16kHz でない場合は、この指定を省略できない。

string
required
Defaults to emo-categorical

実行するサービスに該当する値を指定。emo-categorical。

Responses

Language
Request
Choose an example:
application/json
text/plain