言語識別を行う

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⚠️

言語識別は本サイト上では実行できないため、直接 mimi API を実行してお試しください。

📘

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

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

API 実行に必要なスコープ

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

言語識別結果の種類

mimi LID では、言語識別結果の内容を以下のように区別しています。

最終結果

言語識別処理の最後の応答 JSON。
応答結果 JSON 内の "status": "recog-finished" である応答。

途中結果

WebSocket API で言語識別を行う際に、最終結果の前に得られる応答 JSON 。
応答結果 JSON 内の "status": "recog-in-progress" である応答。

実行

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

WebSocket リクエスト実行例は ドキュメント WebSocket Service の実行例 を参照ください。

応答例

応答例

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

応答結果 JSON

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

キー内容
session_idセッションID。
status言語識別結果のステータス。
・recog-in-progress=処理中
・recog-finished=処理終了
type言語識別の型。
lid# に続く値は x-mimi-lid-options の指定によって変化する。
response言語識別結果配列。
    lang言語コード。
x-mimi-lid-options の指定によって変化する。
    score言語識別結果の信頼度。
0 以上 1 以下の数値で、1 に近づくほど信頼度が高い。
x-mimi-lid-optionsで指定した全ての言語コードについて信頼度を合計すると、1 となる。
そのため、意味のある言語識別結果を得るためには、x-mimi-lid-optionsにて 2言語以上を指定することが望ましい。
Body Params
file
required

リクエストボディ全体が Content-Type で指定したフォーマットのバイナリデータ。cURL コマンドのオプション --data-binary の引数としてファイルを指定する場合は 先頭に @ をつけなければ送信できない ことに留意。

Headers
string
required
Defaults to Bearer <accessToken>

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

string
Defaults to lang=ja|en|zh|ko

言語識別の範囲指定。 パイプ(|)区切りで言語コードを繋ぐ。 デフォルトは lang=ja|en|zh|ko。指定可能な言語コード:ja (日本語) , en (英語), zh (中国語[簡体字]), ko (韓国語), es(スペイン語), fil(フィリピン語), fr(フランス語), id (インドネシア語), my (ミャンマー語), pt-BR(ブラジルポルトガル語), th (タイ語), vi (ベトナム語)。

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
LoadingLoading…
Response
Choose an example:
application/json
text/html