請求とクレジット
API バージョン 2026-10-virile-dragon
2 つの支払い方法
クライアントの課金方法は 2 種類あり、その方式は作成時に固定されます。allowance クライアントは所有者のプランの利用枠を消費します。これはアプリと同じ利用枠で、カードに請求されることはありません。metered クライアントは利用枠を消費せず、呼び出しごとにクレジットがかかり、従量課金サブスクリプションに登録したカードに請求されます。アプリが認可コードから得たトークンで別のユーザーの代わりに行う呼び出しは、クライアントの方式にかかわらず、常にそのユーザーの利用枠を消費します。
呼び出しごとのクレジット
metered クライアントの呼び出しには、そのスコープに設定されたクレジットがかかります。各スコープのクレジットは下の表のとおりで、0 クレジットのスコープは無料です。GET /v1/usage が報告する units は、この重みでクレジットに換算されます。呼び出しは、クライアントがどのバージョンに固定されていても、その呼び出しを行った日に有効な重みで課金されます。古いバージョンのリファレンスにある表は、そのバージョンが公開された時点の重みを記録したもので、現在の呼び出しの費用を示すものではありません。
vocab:generate | 単語リストを生成します。 | 単語リストを生成 |
lesson_plans:read | 自分のレッスンプランを読み取り、その進捗に再接続します。 | レッスンプランを取得レッスンプランに再接続 |
lesson_plans:write | レッスンプランを作成します。 | レッスンプランを作成 |
tutor:converse | チューターと会話します。有料プランが必要です。 | チューターに1ターン送信 |
usage:read | 残りの利用枠、または `metered` クライアントの今月の利用量を確認します。 | 残りの利用枠を取得 |
events:read | 自分のアカウントに関するイベントを読み取り、それを受け取るエンドポイントを登録します。 | イベントを一覧表示イベントをストリーム配信 |
events:write | ゲームや連携から Lingara にイベントを送信します。 | イベントを送信 |
embed:mint | ゲームやサイトのプレイヤー向けに短期間のトークンを発行し、プレイヤーを削除します。従量制クライアントのみ。 | プレイヤーのトークンを発行プレイヤーを削除プレイヤーと Lingara アカウントのリンクを解除 |
embed:play | プレイヤーの代わりに操作します：練習結果を送信し、NPCとの会話を行います。 | プレイヤーを Lingara アカウントにリンクNPC にセリフを送る |
料金
1 クレジットは US$0.004 です。利用分は毎月、各暦月（UTC の 1 日から始まる月）ごとに、従量課金サブスクリプションに登録したカードに請求されます。
支出上限
アカウントにはクレジット単位の月間上限があり、各 metered クライアントにはそれより低い独自の上限を設定できます。どちらも「連携」ページで設定します。クライアントまたはアカウントが上限に達すると、翌月が始まるか上限が引き上げられるまで、クライアントの呼び出しは 402 とコード spend_cap_reached で拒否されます。
従量課金が有効でないとき
従量課金が有効でない間、つまり設定する前、支払いが滞っている間、解約した後は、metered クライアントの呼び出しは 402 とコード metered_billing_inactive で拒否されます。従量課金の設定、管理、解約は「連携」ページ（app.getlingara.com/admin）で行います。管理を選ぶと Stripe の請求ポータルが開き、カードの変更や請求書の確認ができます。
翻訳と英語版リファレンスの内容が異なる場合は、英語版リファレンスが正しいものとします。