文章のアノテーション
文章をまるごと 1 回の呼び出しで。語ごとに 1 行、辞書がその語について持つ情報を返します。
呼び出し
POST /v1/annotate は、JSON ボディの passage で文章を受け取り、文章に出てくる順に語ごとの行を返します。文章は日本語でも英語でも、混ざっていてもかまいません。語の言語は文字の種類で決まるので、リクエストでは指定しません。句読点や記号には行がありません。1 回に送れる長さはリファレンスにあります。
1 行の中身
語とは、辞書がひとつの表記として持つ最も長いまとまりです。見に行きました は 5 行ではなく、活用形の名前が付いた 1 行になります。どの行も同じ項目を持ち、その語にないものは null です。
| 項目 | 内容 |
|---|---|
surface | 文章に書かれたままの語。 |
start, end | 文章の中での始まりと終わり。Unicode のコードポイントで 0 から数え、終わりの位置は含みません。 |
lang | jpn または 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.