Metaplex x402 APIリファレンス

Metaplex x402 APIはhttps://api.metaplex.com/x402で提供され、3つの有料サービス、2つの無料ディスカバリーエンドポイント、4つのエージェント委任ルートを公開しています。このページはエンドポイント、料金、クライアントエクスポートのリファレンスです。有料エンドポイントに必要な支払い対応fetchの構築方法は支払いモードガイドで説明しています。

概要

すべての有料エンドポイントは、未払いのリクエストに対してHTTP 402と、何をいくら支払えばよいかを正確に記述したPAYMENT-REQUIREDヘッダーを返し、クライアントは支払い証明と共に再試行します。標準ウォレットモードと、Coreアセットまたはエージェントが直接支払うモードでは、支払いごとにローカルで署名します。委任されたエージェントの場合は、メッセージ署名で一度認証を行い、サービスがエージェントのウォレットから支払いを構築します。ディスカバリーエンドポイントには支払いも署名者も不要です。

• ベースURL — APIはhttps://api.metaplex.com/x402、Solana JSON-RPCはhttps://api.metaplex.com/x402/rpc
• ワイヤーフォーマット — チャットと画像は正規のOpenAIリクエスト/レスポンスボディ、RPCは標準のSolana JSON-RPC
• 決済 — Solanaメインネット上のUSDC、x402プロトコルバージョン2、exactスキーム
• クライアントバージョン — @metaplex-foundation/x402 0.1.0、Node.js 20.18+、ESMのみ

ベースURLと定数

クライアントは両方のベースURLをエクスポートしているため、アプリケーション側でハードコードする必要はありません。

エンドポイント

有料エンドポイントには支払い対応のfetchが必要で、無料エンドポイントには不要です。

委任ルートはクライアントエクスポートに挙げたSDKヘルパーでラップされています。ルートを直接呼ばず、これらのヘルパーを使ってください。

ディスカバリーエンドポイント

ディスカバリーエンドポイントは無料で呼び出せ、クライアントのヘルパー経由で型付きデータを返します。

import { getModels, getPricing } from '@metaplex-foundation/x402';

// Available model IDs, e.g. 'openai/gpt-5.4-mini'.
const models = await getModels();

// Per-model token rates, request minimums, RPC method prices, and legal URLs.
const pricing = await getPricing();

GET /x402/modelsはOpenAI形式のモデル一覧を返します。

{
  "object": "list",
  "data": [
    { "id": "anthropic/claude-opus-4.8", "object": "model", "created": 0, "owned_by": "anthropic" },
    { "id": "openai/gpt-5.4-mini", "object": "model", "created": 0, "owned_by": "openai" }
  ]
}

チャット補完エンドポイント

POST /x402/chat/completionsは正規のOpenAIチャット補完ボディを受け取って返し、モデルは<provider>/<model>形式で指定します。

import { METAPLEX_X402_BASE_URL } from '@metaplex-foundation/x402';
import OpenAI from 'openai';

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

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

Vercel AI SDKは、OpenAI互換プロバイダーを介して同じエンドポイントに到達します。

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
import { METAPLEX_X402_BASE_URL } from '@metaplex-foundation/x402';
import { generateText } from 'ai';

const metaplex = createOpenAICompatible({
  name: 'metaplex-x402',
  apiKey: 'x402',
  baseURL: METAPLEX_X402_BASE_URL,
  fetch: fetchWithPayment,
});

const { text } = await generateText({
  model: metaplex.chatModel('openai/gpt-5.4-mini'),
  prompt: 'Say hi in one word.',
});

画像生成エンドポイント

POST /x402/images/generationsは正規のOpenAI画像生成ボディを受け取ります。

const image = await openai.images.generate({
  model: 'openai/gpt-image-1.5',
  prompt: 'A yellow square.',
  size: '1024x1024',
});

import { generateImage } from 'ai';

const { image } = await generateImage({
  model: metaplex.imageModel('openai/gpt-image-1.5'),
  prompt: 'A yellow square.',
  size: '1024x1024',
});

Solana RPCエンドポイント

POST /x402/rpcは標準のSolana JSON-RPCリクエストを受け付け、DASメソッドをパススルーし、リクエストごとに個別に課金・決済します。

import { createSolanaRpcFromTransport, type RpcTransport } from '@solana/kit';
import { METAPLEX_X402_RPC_URL } from '@metaplex-foundation/x402';

const rpcTransport: RpcTransport = async ({ payload, signal }) => {
  const response = await fetchWithPayment(METAPLEX_X402_RPC_URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(payload),
    signal: signal ?? null,
  });

  return response.json();
};

const rpc = createSolanaRpcFromTransport(rpcTransport);
const slot = await rpc.getSlot().send();

import { METAPLEX_X402_RPC_URL } from '@metaplex-foundation/x402';
import { Connection } from '@solana/web3.js';

const connection = new Connection(METAPLEX_X402_RPC_URL, {
  fetch: fetchWithPayment,
});
const slot = await connection.getSlot();

支払いチャレンジのフィールド

有料エンドポイントへの未払いリクエストは、base64エンコードされたPAYMENT-REQUIREDヘッダーとともにHTTP 402を返します。@metaplex-foundation/x402で構築したクライアントはこれを自動的に解析します。以下のフィールドは、デバッグ用途およびJavaScript以外のクライアント向けのドキュメントです。

チャット補完の料金

チャットモデルは100万トークンあたりの単価で、入力・キャッシュ入力・出力それぞれに個別のレートがあり、1リクエストあたり$0.001の最低額が適用されます。以下のレートは2026-09-08にGET /x402/pricingから取得したものです。

openai/gpt-5.5とopenai/gpt-5.4は、入力272,000トークンを超えるとロングコンテキストの高いレートが適用されます — gpt-5.5は入力$10.00・出力$45.00、gpt-5.4は入力$5.00・出力$22.50です。

画像生成の料金

画像モデルは4区分について100万トークンあたりで課金され、同じく1リクエストあたり$0.001の最低額が適用されます。

Solana RPCの料金

RPC呼び出しはデフォルトで1リクエストあたり$0.00001、負荷の重いメソッドには高いレートが設定されています。

MetaplexSvmExactSchemeのオプション

MetaplexSvmExactSchemeは、Coreアセットおよびエージェントの支払いに使う支払いスキームです。

このスキームはUmiの署名者とSolana Kitのパーシャルトランザクション署名者を受け付けますが、sign-and-send署名者は受け付けません。Kitの署名者は内部で変換されます。

クライアントエクスポート

@metaplex-foundation/x402は、公開APIをパッケージルートに集約しています。

オプション型と結果型、プロトコル定数、委任ルートのスキーマもパッケージルートからエクスポートされています。

環境変数

x402リポジトリの実行可能なサンプルは、以下の変数を読み込みます。

注意事項

• このリファレンスの価格は2026-09-08に取得したスナップショットです。実効的な価格表はライブサービスのGET /x402/pricingであり、無料で呼び出せます。
• 支払いはクラシックなSPL Tokenの関連トークンアカウントからUSDCで決済されます。Token-2022の支払いミントは現在サポートされていません。
• Coreアセットおよびエージェントの支払いモードでは、Core execute手数料のためにアセットシグナーPDAにSOLが必要です。標準ウォレットの支払いには不要です。
• ホストされたサーバーはオープンソースではありません。クライアント、そのサンプル、プロトコル型はApache-2.0で公開されています。
• 本APIの利用は、Metaplex.com利用規約およびプライバシーポリシーへの同意を意味します。

クイックリファレンス

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