文章のアノテーション

文章をまるごと 1 回の呼び出しで。語ごとに 1 行、辞書がその語について持つ情報を返します。

呼び出し

POST /v1/annotate は、JSON ボディの passage で文章を受け取り、文章に出てくる順に語ごとの行を返します。文章は日本語でも英語でも、混ざっていてもかまいません。語の言語は文字の種類で決まるので、リクエストでは指定しません。句読点や記号には行がありません。1 回に送れる長さはリファレンスにあります。

curl 'https://api.immit.co/v1/annotate' \
  -H "Authorization: Bearer $IMMIT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"passage":"夜八時には私は映画を見に行きました。"}'
200 · 抜粋
{
  "characters": 18,
  "rows": [
    {
      "surface": "夜",
      "start": 0,
      "end": 1,
      "lang": "jpn",
      "headword": "夜",
      "reading": "よる",
      "other_readings": [
        "よ"
      ],
      "form": null,
      "accent": 1,
      "frequency_band": "very_common",
      "pos": "名詞",
      "gloss": "night"
    },
    {
      "surface": "八",
      "start": 1,
      "end": 2,
      "lang": "jpn",
      "headword": "八",
      "reading": "はち",
      "other_readings": [],
      "form": null,
      "accent": 2,
      "frequency_band": "very_common",
      "pos": "名詞",
      "gloss": "eight"
    },
    // … 6 more rows
    {
      "surface": "見に行きました",
      "start": 10,
      "end": 17,
      "lang": "jpn",
      "headword": "見に行く",
      "reading": "みにいきました",
      "other_readings": [],
      "form": {
        "name": "過去形",
        "translations": {
          "eng": "past"
        },
        "tone": "polite",
        "polarity": "positive"
      },
      "accent": null,
      "frequency_band": "uncommon",
      "pos": "動詞",
      "gloss": "to go to see"
    }
  ]
}

1 行の中身

語とは、辞書がひとつの表記として持つ最も長いまとまりです。見に行きました は 5 行ではなく、活用形の名前が付いた 1 行になります。どの行も同じ項目を持ち、その語にないものは null です。

項目内容
surface文章に書かれたままの語。
start, end文章の中での始まりと終わり。Unicode のコードポイントで 0 から数え、終わりの位置は含みません。
langjpn または eng。
headword基本形。その語のエントリーの見出し語で、エントリー取得に渡せば全体が返ります。人名など、エントリーのない語では null です。
reading日本語のみ。その語に選ばれた読み。かなで返ります。
other_readings日本語のみ。その表記が持つほかの読みすべて。
formその語が書かれている活用形。名前とその訳、日本語の語では肯定・否定と普通・丁寧が入ります。基本形の語では null です。
accent日本語のみ。見出し語のピッチアクセント。エントリーにあるのと同じ数字です。
frequency_bandその語がどれくらいよく使われるか。5 つの帯のひとつです。エントリーのない語と、辞書がまだランク付けしていないエントリーでは null です。
pos品詞。その語の言語での名前です。
glossエントリーの最初の訳語。もう一方の言語で返ります。

読み、アクセント、訳語

reading はその語に選ばれた読みです。ひとつの表記に読みがいくつもあることがあり、残りは other_readings に並びます。クライアントは選ばれた読みを表示し、ほかの読みも選べるようにできます。accent は見出し語のものです。活用形は自分のアクセントを持たず、見出し語のアクセントが入ります。gloss はエントリーの最初の訳語です。文章の中での意味とは限らず、すべての語義はエントリーにあります。

料金

文章は 1,000,000 文字で $4。語を引くときと同じ残高から引かれます。空白や句読点も含め、送った文字はすべて数えます。上の文章は 18 文字なので $0.000072 です。拒否されたリクエストでは何も引かれません。

送った文章は保存されません。

クレジット

immitは次の著作者によるソフトウェアを使用しています:The UniDic Consortium、Teruaki Oka「UniDic-cwj 3.1.1」。BSDライセンスの下で使用しています。コンパクト版の著作権表示:Copyright (c) 2023, LegalOn Technologies, Inc.