モデルが書く語をすべて、1 回の呼び出しで

モデルがこれから返す応答を、そのまま送れます。1 回の呼び出しで、語ごとに 1 行が返ります。基本形、読み、活用形、頻度の帯、エントリーの最初の訳語が入り、辞書にあればアクセントも付きます。毎月最初の 500,000 文字は無料です。

カード不要で始められます

POST/v1/annotate200
curl 'https://api.immit.co/v1/annotate' \
  -H "Authorization: Bearer $IMMIT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"passage":"週末は友達と映画を見に行ったんですね。どんな話でしたか。面白かった場面を、日本語で少し教えてください。難しい言葉は使わなくても大丈夫ですよ。"}'
{
  "characters": 70,
  "rows": [
    {
      "surface": "週末",
      "start": 0,
      "end": 2,
      "lang": "jpn",
      "headword": "週末",
      "reading": "しゅうまつ",
      "other_readings": [],
      "form": null,
      "accent": 0,
      "frequency_band": "common",
      "pos": "名詞",
      "gloss": "weekend"
    },
    {
      "surface": "は",
      "start": 2,
      "end": 3,
      "lang": "jpn",
      "headword": "は",
      "reading": "は",
      "other_readings": [],
      "form": null,
      "accent": null,
      "frequency_band": "very_common",
      "pos": "助詞",
      "gloss": "topic marker"
    },
    // … 4 more rows
    {
      "surface": "見に行った",
      "start": 9,
      "end": 14,
      "lang": "jpn",
      "headword": "見に行く",
      "reading": "みにいった",
      "other_readings": [],
      "form": {
        "name": "過去形",
        "translations": {
          "eng": "past"
        },
        "tone": "plain",
        "polarity": "positive"
      },
      "accent": null,
      "frequency_band": "uncommon",
      "pos": "動詞",
      "gloss": "to go to see"
    },
    // … 21 more rows
  ]
}
  • x-ratelimit-remaining: 299
  • x-balance-remaining: 1.99972

すでに用意されているもの

活用した語もまるごと 1 行、基本形付き
「見に行った」は 1 行で返ります。基本形は「見に行く」で、語ごとにデータを持つときのキーになります。活用形の名前(過去形、英語では past)も付いています。
選ばれた読みと、ほかの読み
日本語の語には、選ばれた読みがかなで入り、その表記が持つほかの読みも並びます。「話」は「はなし」で、ほかの読み「わ」も付いています。
語の頻度
辞書がランク付けした語には、「とてもよく使う」から「とてもまれ」まで、頻度の帯が付きます。
日本語と英語が混ざった文章も
文章に日本語と英語が混ざっていてもかまいません。日本語の語には英語の、英語の語には日本語の、エントリーの最初の訳語が付きます。

モデルの応答から、学習者の画面へ

turn.txt
週末は友達と映画を見に行ったんですね。どんな話でしたか。面白かった場面を、日本語で少し教えてください。難しい言葉は使わなくても大丈夫ですよ。
turn.py
import os, re, requests

API = 'https://api.immit.co/v1/annotate'
KEY = {'Authorization': 'Bearer ' + os.environ['IMMIT_API_KEY']}
NOT_KANA = re.compile('([^ぁ-ゖァ-ヺー]+)')

def furigana(word, reading):
    if reading in (None, word):
        return word
    parts = NOT_KANA.split(word)
    kana = ''.join('(.+)' if i % 2 else p for i, p in enumerate(parts))
    found = re.fullmatch(kana, reading)
    if not found:
        return f'<ruby>{word}<rt>{reading}</rt></ruby>'
    over = iter(found.groups())
    return ''.join(f'<ruby>{p}<rt>{next(over)}</rt></ruby>' if i % 2 else p
                   for i, p in enumerate(parts))

turn = open('turn.txt').read().strip()
res = requests.post(API, headers=KEY, json={'passage': turn})
res.raise_for_status()

page, at, cards = '', 0, {}
for row in res.json()['rows']:
    page += turn[at:row['start']]
    page += furigana(row['surface'], row['reading'])
    at = row['end']
    if row['headword']:
        form = row['form']
        cards[row['surface']] = [
            row['headword'],
            form and form['translations'].get('eng', form['name']),
            row['accent'],
            row['frequency_band'],
            row['gloss'],
        ]

print(page + turn[at:])
print(cards)
学習者の画面 · 面白かった をタップしたところ

週末しゅうまつは友達ともだちと映画えいがを見みに行いったんですね。どんな話はなしでしたか。面白おもしろかった場面ばめんを、日本語にほんごで少すこし教おしえてください。難むずかしい言葉ことばは使つかわなくても大丈夫だいじょうぶですよ。

面白いpastアクセント 4very_common

interesting

かかる費用

毎月 $2 の無料枠のあと、1,000,000 文字あたり $4。上の応答は 70 文字なので $0.00028 です。

料金を見る

1 か月に 1,000 回の応答

70,000 文字 × $0.000004
$0.28
無料枠
−$0.28
お支払い$0.00

今月の無料枠が $1.72 残ります。

1 か月に 100,000 回の応答

7,000,000 文字 × $0.000004
$28.00
無料枠
−$2.00
残りの支払い
$26.00
お支払い$26.00

1 回のチャージです。

よくある質問

どの語にもアクセントがありますか?
いいえ。accent は見出し語のアクセントで、基本形について辞書が持つ数字です。活用形には独自のアクセントがなく、見出し語のものが入ります。辞書にアクセントがあるのは、最もよく使われる 5,000 語の読みの 85%、日本語のエントリー全体では 30% です。ない語では accent は null になります。
読みはいつも正しいですか?
いいえ。reading はその語に選ばれた読みです。ひとつの表記に読みがいくつもあることがあり、残りは other_readings に並ぶので、プロダクトの側でほかの読みも選べるようにできます。gloss はエントリーの最初の訳語です。文章の中での意味とは限らず、すべての語義はエントリーにあります。
1 回の呼び出しにどのくらいかかりますか?
リクエスト 1 回にレスポンス 1 回で、ジョブの完了を待つことも、ポーリングすることもありません。音声対話で使う場合は、無料枠の範囲で、自分のサーバーから時間を測ってみてください。
送った文章は保存されますか?
いいえ。送った文章は保存されません。
語を 1 つずつ引くのと何が違いますか?
語を引くと、すべての語義、例文、音声を含むエントリー全体が返り、1 語分の料金がかかります。応答に出てくる語をまとめて調べるなら、文章として送るほうが安くなります。上の応答は 1 回の呼び出しで $0.00028、28 語を 1 つずつ引くと $0.0112 です。学習者がある語をもっと知りたいときは、headword でエントリーを取得できます。
モデルからツールとして呼べますか?
はい。MCP サーバーに annotate_passage として用意されています。同じキー、同じ残高で使えます。

キーひとつと、毎月 $2 の無料枠。