Noriの価格と課金

Noriは、公開されたバージョン管理済みのレートカードに基づいてすべての呼び出しをUSDで価格付けし、課金の瞬間にSOLに換算し、成功時にのみ課金します — 失敗したアップストリーム呼び出しに課金されることは決してありません。価格変更は予告期間ポリシーに従い、呼び出し元が委任を解除した場合やウォレットが課金をまかなえない場合、課金は即座にハードストップします。

概要

Noriの課金モデルは外部から監査可能であるように設計されています: 公開された価格、オンチェーンのレシート、サービスなしの課金は一切なし。

• レートカード — GET /rate-cardが、バージョン、effective_at、マークアップ係数、価格変更ポリシーを含む完全なUSDプライスブックを提供
• 成功時課金 — アップストリームの呼び出しが先に実行され、失敗は課金なしでエラーを返し、x402の支払い後の再試行は呼び出しを再実行せずキャッシュ済みの結果を返す
• 価格変更の予告 — 値上げは少なくともnotice_period_days（デフォルト7）だけ未来のeffective_at付きでコミットされ、それ以前の課金は以前に公開されたレートのまま
• ハードストップ — 委任解除とウォレット残高切れはどちらもデリゲートペイの課金を即座に停止し、呼び出しは負債を蓄積する代わりにx402チャレンジにフォールバック

Noriのレートカード

GET /rate-cardは正規の機械可読な価格表です — ドキュメント内のスナップショットに頼らず、常にこちらを確認してください。完全なプライスブックとポリシーメタデータを5分キャッシュで提供します:

{
  "version": 1,
  "effective_at": "2026-05-21T00:00:00.000Z",
  "policy": {
    "notice_period_days": 7,
    "notice_url": "https://github.com/metaplex-foundation/agent-plumber/blob/main/packages/shared/src/pricebook.json",
    "description": "Price changes are announced by editing this file..."
  },
  "markup_factor": 1.25,
  "llm": {
    "anthropic/claude-sonnet-4-6": {
      "inputPerMillion": 3.0,
      "outputPerMillion": 15.0,
      "cachedInputPerMillion": 0.3
    }
  },
  "image": { "openai/gpt-image-1": { "perImage": 0.04 } },
  "rpc": { "default": { "perCall": 0.0001 } }
}

レートカードのスキーマ

掲載価格は卸売価格です。課金される金額は卸売価格 × markup_factorです。GET /v1/modelsは、OpenAI SDKクライアント向けに同じソースから利用可能なLLMモデルIDを列挙します。

課金額の算出方法

各サービスはレートカードからUSDコストを計算し、課金時にSOLに換算します。

1. サービスハンドラーが結果とcostUsdを返します — chat.completionはトークン数 × 100万あたり価格、image.generationは画像あたり、solana.rpcは呼び出しあたり
2. 卸売コストにマークアップ係数（1.25倍）が適用されます
3. USD額は、Jupiter価格APIのライブSOL/USDスポット価格（30秒キャッシュ）を使ってラマポートに換算されます
4. 課金は、エージェントのPDAからNoriのサービスPDAへの、Memoレシート付きSOL送金として成立します

成功時課金の会計処理

Noriは、正常に提供しなかった呼び出しに課金することは決してありません。両方の決済レールで、アップストリームが先、課金が後という順序です:

• デリゲートペイのレール — Noriはアップストリームの呼び出し（LLM、画像、RPC）を実行し、成功すればPDAに課金して結果を返します。アップストリームの呼び出しが失敗した場合、呼び出し元はエラーレスポンスを受け取り、課金はありません。
• x402のレール — 最初の（支払い前の）リクエストがアップストリームの呼び出しを実行し、支払いチャレンジをキーとして結果をキャッシュします。402レスポンスは、すでに計算済みの結果の正確なコストを見積もりとして提示します。呼び出し元が支払って再試行すると、Noriはキャッシュ済みの結果を返します — アップストリームの呼び出しは再実行されないため二重課金は起こり得ず、見積もられた価格がそのまま決済される価格です。

注目すべき失敗ケースはその逆です: デリゲートペイのレールで、アップストリームの呼び出しが成功したのに課金自体が失敗した場合（委任の取り消し、ウォレットの残高切れ）、呼び出し元はその1回の結果を未払いのまま受け取る可能性があり、その後レールはハードストップします。Noriは、事前に資金を人質に取る代わりに、その1回分の損失を負担します。

価格変更の予告ポリシー

価格変更はレートカード自体を通じて事前に告知されます — デリゲートペイのレールで無告知の値上げはありません。カードのpolicyブロックに埋め込まれたポリシーは次のとおりです:

1. 価格変更は、versionをインクリメントし未来のeffective_atを持つ新しいカードのコミットによって公開されます
2. 値上げの場合、effective_atはコミットから少なくともnotice_period_days（デフォルト7日）後でなければなりません
3. effective_at以前の課金は、以前に公開されたレートのまま継続されます
4. 完全な変更履歴はpolicy.notice_urlで公開されています

承諾は委任時に暗黙的に行われます: 委任することで、エージェントは公開されているカードとその予告ポリシーを受け入れます。公開された変更が受け入れられない場合は、effective_atより前に委任を取り消してください — 取り消しは即時のハードストップなので、承諾していないレートで課金が成立することはありません。

プログラムで変更を監視するには、GET /rate-cardをポーリングし（5分キャッシュされます）、versionのインクリメントやeffective_atの変動時にアラートを出します。

ハードストップのセマンティクス

2つの条件が、ポリシーではなく構造によって、デリゲートペイの課金を即座に停止します: チェーンが課金を拒否するため、負債は蓄積し得ません。

委任解除時のハードストップ

実行委任の取り消しは、チェーンレベルでNoriの課金権限を終了させます。次の課金試行はNeither the asset or any plugins have approved this operationで失敗し、Noriはそのアセットのキャッシュ済みデリゲートステータスを破棄し、以降の呼び出しはx402のレールにフォールスルーします — 呼び出し元は自動課金の代わりにHTTP 402の支払いチャレンジを受け取ります。デリゲートステータスは最大5分間キャッシュされるため、取り消し直後の処理中の呼び出し1件はデリゲート課金を試行して（そして失敗して）しまう可能性があります。停止を強制するのはオンチェーンのチェックなので、取り消し後に課金されることはありません。

ウォレット残高切れ時のハードストップ

エージェントのPDAが課金をまかなえない場合、デリゲート課金は失敗し、呼び出しが信用払いで提供されることはありません。呼び出し元はx402チャレンジ（HTTP 402）を受け取り、その呼び出しを直接支払うか、PDAを補充してデリゲートペイを再開するかを選べます。Noriは信用枠を一切提供しません — 資金不足のエージェントはチャレンジ付きの呼び出しごと払いに格下げされるだけで、負債を蓄積することはありません。

運用上は、両方のハードストップをエージェントの監視シグナルとして扱いましょう: これまでデリゲートペイで支払われていた呼び出しが200レスポンスから402チャレンジへ突然変わったなら、委任が消えたかウォレットが空になったということです。

クイックリファレンス

注意事項

• ソースリポジトリにバンドルされているプライスブックは、リリース時点の公開定価のスナップショットです。ライブインスタンスのGET /rate-cardが実効的な価格表です
• レートカードの価格は卸売価格です — 課金額を求めるにはmarkup_factorを掛けてください
• 同じ呼び出しでも、実際に課金されるラマポートは課金時のSOL/USDレートによって変動します。カードが固定するのはUSD額です
• ハードストップはデリゲートペイのレールに適用されます。x402のレールは本質的に呼び出しごとの前払いであり、同等の障害モードはありません
• Noriをリファレンス実装としてフォークするオペレーターは、packages/shared/src/pricebook.jsonを直接編集し、同じeffective_at予告の規律を守るべきです

Metaplex Foundationが管理。最終確認日: 2026-07-08。GitHubでソースを見る。

FAQ

Noriの価格と課金に関するよくある質問。

Noriの呼び出しが失敗した場合、課金されますか？

いいえ。Noriはアップストリームの呼び出しを先に実行し、成功した場合にのみ課金します。失敗したアップストリーム呼び出しは課金なしでエラーを返します。x402レールでは、結果は一度だけ計算されてキャッシュされるため、支払い後の再試行はキャッシュ済みの結果を返し、再実行や二重課金は決して発生しません。

NoriはUSD価格をどのようにSOLに換算しますか？

レートカードはUSD建てです。課金時に、NoriはJupiter価格APIのライブSOL/USDスポット価格（30秒キャッシュ）を使ってSOL額を再計算します。したがって、実際に課金されるラマポートは呼び出し時点の市場レートに追従します。

Noriは価格変更の前にどれくらいの予告をしますか？

レートカードにはnotice_period_days（デフォルト7）を持つpolicyブロックが含まれています。値上げは、少なくとも予告期間だけ未来のeffective_atタイムスタンプ付きでコミットされ、effective_at以前の課金は以前に公開されたレートのまま継続されます。変更履歴はポリシーのnotice_urlで確認できます。

エージェントのウォレットのSOLが尽きたらどうなりますか？

ハードストップします。PDAが課金をまかなえない場合、デリゲートペイの課金は失敗し、呼び出しはHTTP 402のx402チャレンジにフォールバックします — サービスが信用払いで提供されることはありません。PDAを補充すればすぐに呼び出しは再開されます。

利用中にNoriへの委任を解除したらどうなりますか？

次の課金試行はオンチェーンで失敗し、Noriはキャッシュ済みデリゲートステータスを無効化し、デリゲートペイのレールはハードストップします。以降の呼び出しはx402の支払いチャレンジを受け取ります。チェーンがExecuteトランザクションを拒否するため、取り消し後に課金されることはありません。

Noriがエージェントに課金した内容はどこで確認できますか？

すべての課金は、構造化されたレシートを運ぶMemo命令付きの、エージェントのPDAからNoriのサービスPDAへのSOL送金です。エージェントのオンチェーントランザクション履歴が、独立して監査可能な完全な課金記録です。