Metaplex x402 - リクエストごとに支払うAIとSolana RPC

Metaplex x402は、LLM推論、画像生成、Solana RPCのためのリクエスト課金型HTTP APIです — APIキーもアカウントもサブスクリプションもありません。USDCを保有するSolanaウォレット、Coreアセット、または登録済みエージェントを用意すれば、すべてのリクエストがその都度USDCで自動的に支払われます。

概要

Metaplex x402は、HTTPの402 Payment Requiredステータスを機械が支払い可能なフローに変えます。アプリが通常どおりエンドポイントを呼び出すと、サーバーは支払い要件とともに402を返し、クライアントがUSDCの支払いに署名して再試行すると、サーバーがSolana上で決済してレスポンスを返します。このサービスはオンチェーンのMetaplexエージェントであるMechが運用しています。

• 3つのサービス — OpenAI互換のチャット補完、OpenAI互換の画像生成、そしてDASパススルー対応のSolana JSON-RPC
• 3つの支払いモード — 標準ウォレット、Coreアセットまたはエージェントによる直接支払い、そしてリクエストごとの署名なしで支払う委任エージェント
• USDC決済 — 支払いはクラシックなSPL Tokenの関連トークンアカウントから行われ、Token-2022の支払いミントはサポートされていません
• オープンソースのクライアント — @metaplex-foundation/x402はApache-2.0で、12個の実行可能なサンプルが付属します。ホストされたサーバーは公開されていません

Metaplex x402が提供するサービス

Metaplex x402は、単一のベースURLhttps://api.metaplex.com/x402の下で、3つの有料サービスと2つの無料ディスカバリーエンドポイントを公開しています。

チャットと画像のエンドポイントは正規のOpenAIワイヤーフォーマットを話すため、OpenAI互換のクライアントであればbaseURLを変更して支払い対応のfetchを渡すだけで動作します。リクエストとレスポンスの詳細はAPIリファレンスを参照してください。

Mech: Metaplex x402を運用するエージェント

Mechは、x402サービスを販売するオンチェーンのMetaplexエージェントであり、USDCの支払いはMechのCoreウォレットに決済されます。Mech自身もAsset Signer PDAウォレットを持つ登録済みエージェントです — つまりエージェントがあなたのエージェントにサービスを販売しており、これはエージェントコマースのモデルがエンドツーエンドで機能している姿です。

クイックスタート

クライアントをインストールし、支払い対応のfetchを使ってOpenAI SDKをMetaplex x402に向けます。この例は標準ウォレットから支払います。3つのモードすべては支払いモードガイドで詳しく説明しています。

pnpm add @metaplex-foundation/x402 \
  @metaplex-foundation/umi \
  @solana/kit \
  @x402/core \
  @x402/fetch \
  @x402/svm \
  openai

import { METAPLEX_X402_BASE_URL } from '@metaplex-foundation/x402';
import { createKeyPairSignerFromBytes, getBase58Encoder } from '@solana/kit';
import { x402Client } from '@x402/core/client';
import { wrapFetchWithPayment } from '@x402/fetch';
import { ExactSvmScheme } from '@x402/svm/exact/client';
import OpenAI from 'openai';

// A Solana signer whose token account holds USDC.
const svmSigner = await createKeyPairSignerFromBytes(
  getBase58Encoder().encode(process.env.SVM_PRIVATE_KEY!),
);

const paymentClient = new x402Client();
paymentClient.register('solana:*', new ExactSvmScheme(svmSigner));

const openai = new OpenAI({
  // The OpenAI SDK requires a value, but this gateway authenticates by payment.
  apiKey: 'x402',
  baseURL: METAPLEX_X402_BASE_URL,
  fetch: wrapFetchWithPayment(fetch, paymentClient),
});

const completion = await openai.chat.completions.create({
  model: 'openai/gpt-5.4-mini',
  messages: [{ role: 'user', content: 'Say hi in one word.' }],
});

支払いはラップされたfetchの内部で行われ、あなたのコードには最終的なAPIレスポンスだけが見えます。

支払いモードの概要

Metaplex x402は3つの支払い方法をサポートしており、USDCの出所と所有者が署名する頻度が異なります。

委任はいつでも取り消せるオンチェーンの許可です。それぞれのセットアップ、コード、取り消し手順は支払いモードガイドにあります。

Metaplex x402のリクエスト課金の仕組み

Metaplex x402は推論を上流プロバイダーのトークン単価で、RPCをリクエスト単位で課金し、最新のレートカードをGET /x402/pricingで無料公開しています。

• チャット補完 — 100万トークンあたりの単価で、入力・キャッシュ入力・出力それぞれに個別のレートがあり、1リクエストあたり$0.001の最低額が適用されます
• 画像生成 — 入力テキスト、入力画像、出力画像、出力テキストの4区分について100万トークンあたりで課金され、同じく$0.001の最低額が適用されます
• Solana RPC — デフォルトで1リクエストあたり$0.00001、getSignaturesForAddressのような重いメソッドは$0.0001など高いレートになります

注意事項

• 支払いはクラシックなSPL Tokenの関連トークンアカウントからUSDCで決済されます。Token-2022の支払いミントは現在サポートされていません。
• Coreアセットおよびエージェントの支払いモードでは、Core executeのトランザクション手数料をまかなうために、アセットシグナーPDAに少額のSOL残高が必要です。標準ウォレットの支払いにSOLは不要で、サービス側のフィーペイヤーがネットワーク手数料を負担します。
• x402のRPCエンドポイントはHTTPリクエストのみをサポートします。WebSocket接続とサブスクリプションはサポートされていません。
• ホストされたサーバーはオープンソースではありません。クライアント、そのサンプル、プロトコル型はApache-2.0で公開されています。
• 本サービスの利用は、Metaplex.com利用規約およびプライバシーポリシーへの同意を意味します。

クイックリファレンス

FAQ

Metaplex x402に関するよくある質問。

Metaplex x402とは何ですか？

Metaplex x402は、LLM推論、画像生成、Solana RPCアクセスを販売するリクエスト課金型のHTTP APIです。APIキー、アカウント、サブスクリプションは不要で、各リクエストはx402プロトコルを使ってSolana上でUSDC決済されます。x402は、HTTPの402 Payment Requiredステータスを機械が支払い可能なフローに変えるプロトコルです。

Metaplex x402を使うのにAPIキーやアカウントは必要ですか？

いいえ。支払いが認証そのものです。必要なのはUSDCを保有するSolanaウォレット、Coreアセット、または登録済みエージェントだけです。OpenAI SDKは空でないapiKey値を要求するため、例では文字列'x402'を渡していますが、ゲートウェイはこれを無視します。

Mechとは何ですか？

Mechは、x402サービスを運用するオンチェーンのMetaplexエージェントです。支払いはMechのCoreウォレット — そのAsset Signer PDA — にUSDCで決済されます。Mechはあなたのエージェントやウォレットにサービスを販売するエージェントであり、アドレスはMECHjj31U1hBapoVeJtZo5U5WGRd2293JEwRErvPTuFです。

Noriサービスエージェントのドキュメントはどうなりましたか？

Noriのページは、一般公開されることなく現在は保守されていない初期プロトタイプを説明したものでした。それを置き換えて実際にリリースされたサービスがMetaplex x402です。現在Noriという名称はMetaplex AIコパイロットを指しており、有料推論やRPCとは無関係の別プロダクトです。

Metaplex x402の課金はSOLですか、USDCですか？

USDCです。支払いはクラシックなSPL Tokenの関連トークンアカウントから行われ、Token-2022の支払いミントはサポートされていません。Coreアセットおよびエージェントの支払いモードでは、Core executeのトランザクション手数料をまかなうために、アセットシグナーPDAに少額のSOL残高も必要です。

Metaplex x402のサーバーはオープンソースですか？

クライアントはオープンソースです。TypeScriptクライアント、そのサンプル、プロトコル型はgithub.com/metaplex-foundation/x402にApache-2.0で公開されています。ホストされたサービスを動かすサーバーは現在公開されていません。

1回のリクエストの費用はどれくらいですか？

推論の料金は上流プロバイダーのトークン単価に準拠し、1リクエストあたり$0.001の最低額が適用されます。RPC呼び出しは$0.00001からのリクエスト単位課金で、負荷の重いメソッドには高いレートが設定されています。GET /x402/pricingは最新のレートを返し、無料で呼び出せます。

用語集

Metaplex x402のドキュメント全体で使用される用語。

Metaplex Foundationが管理。最終確認日: 2026-09-08。クライアントバージョン: @metaplex-foundation/x402 0.1.0。GitHubでソースを見る。