Named Entity Recognition API

Named Entity Recognition(NER) APIは、自然言語の文章から各ドメインにおいて重要なキーワードを抽出することができます。

API Server

AllganizeのAPIエンドポイントはnlu-api.allganize.aiです。On-premプランのご利用の場合は、ご希望のAPIエンドポイントを使用してください。

APIキーの取得

すべてのNLU APIは、リクエストを検証するためにAPIキーを使用しています。APIキーはNLU APIのプロジェクト設定メニューから確認できます。NLU APIダッシュボードのアカウントがない場合は、こちらから生成してください。

RequestヘッダーのAPI-KEY に割り当てられたAPI KEY を入力してください。

Named Entity Recognition API

POST https://nlu-api.allganize.ai/api/inference

Headers

Name	Type	Description
API-KEY	string	割り当てられたAPIキーです。プロジェクト設定メニュー>一般タブから確認できます。

Request Body

Name	Type	Description
text	string	分析対象のテキストです。英語、日本語、韓国語、中国語で対応できます。最大2000文字まで入力できます。2000文字以降の内容は自動で入力・分析されません。

200

Responseにはリクエストのあったテキストに対する分析結果が含まれています。

startIndex: Named entityとして認識された単語の開始位置を意味します。数字で表示されます。

endIndex: Named entityとして認識された単語の終了位置を意味します。数字で表示されます。

tag: 該当のNamed entityのタイプ(カテゴリ)です。タイプの種類はNLU APIのダッシュボードから定義することができます。

token: Named entityとして認識された単語です。

{
  "entities": [
    {
      "startIndex": NUMBER,
      "endIndex": NUMBER,
      "tag": STRING,
      "token": STRING
    }, ...
  ]
}

Request Example

YOUR API KEYをプロジェクトのAPIキーに変更しなければなりません。APIキーの取得の項目をご参照ください。

curl https://nlu-api.allganize.ai/api/inference \
-d '{"text": "ミュンヘンからパリまでエールフランスのビジネスクラスで旅行中です。"}' \
-H "Content-Type: application/json" \
-H "API-KEY: YOUR_API_KEY"

Response Example

{
  "inputText": "ミュンヘンからパリまでエールフランスのビジネスクラスで旅行中です。",
  "entities": [
    {"startIndex": 0, "endIndex": 5, "tag": "DEPARTURE", "token": "ミュンヘン"},
    {"startIndex": 7, "endIndex": 9, "tag": "ARRIVAL", "token": "パリ"},
    {"startIndex": 11, "endIndex": 18, "tag": "AIRLINE", "token": "エールフランス"},
    {"startIndex": 19, "endIndex": 26, "tag": "SEAT_CLASS", "token": "ビジネスクラス"}
}