X402 Video

io.github.x402-video由 GitHub 帳號 x402-video 發布v0.1.1更新於 Oct 24, 2026

Pay-per-call AI video generation over x402 (USDC on Base). No accounts, no API keys.

已驗證STDIO僅桌面金融媒體與設計

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理透過 x402 協定在 Base 上以 USDC 按次付費生成 AI 影片，不需帳號或 API 金鑰。

可以做什麼
  • 瀏覽即時影片目錄與目前美元價格，並查看公開的可靠性統計
  • 在不付費的情況下取得某次請求的精確 USDC 報價
  • 從消費錢包支付報價後生成影片，回傳任務 ID
  • 輪詢任務狀態並取得生成的影片連結
  • 免費提交關於價格、缺少功能、品質或錯誤的意見
適用情境
適合需要助理隨選生成短影片片段、並以加密貨幣按次付費而不想持有廠商帳號或訂閱的情境。免費工具（目錄、報價、任務輪詢）可在沒有錢包的情況下先試用。
執行需求
透過 npx 以 stdio 在本機執行（需要 Node.js）。付費生成需要一個在 Base 上存有少量 USDC 的專用消費錢包，透過 BUYER_PRIVATE_KEY 提供。選用設定：MAX_USD_PER_CALL（預設 5）與 GATEWAY_URL。需要能連線至閘道的網路。
安裝前請注意
BUYER_PRIVATE_KEY 是用來簽署付款的錢包私鑰，應使用餘額很低的專用錢包，切勿使用主錢包。每次生成都會花費真實 USDC，長時數 1080p 片段價格可達約 9.82 美元，建議把 MAX_USD_PER_CALL 設低。提示詞與意見會傳送給第三方閘道，影片連結 24 小時後失效。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 X402 Video，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

x402-video MCP server

Give any MCP-capable agent (Claude Code, Claude Desktop, Cursor, ...) the ability to generate AI videos and pay per call — USDC on Base over the x402 protocol. No accounts, no API keys, no credit cards.

quote_price → generate_video (pays exact USDC quote, gasless) → get_job → video_url

Backed by x402video.com. Seedance 2.0, 5s 720p: Mini $0.67, Fast $1.05, Standard $1.33 per clip. Custom 4–15s with optional audio: Mini $0.26–$2.00 and Fast $0.40–$3.15 (480p/720p), Standard $0.49–$9.82 (up to 1080p). The exact USDC price is always the live 402 quote. Prompts are screened before payment; rejected requests are never charged.

Tools

ToolCostWhat
list_skusfreeLive catalog + current USD prices
get_statsfreePublic reliability stats (success rate, p50 generation time)
quote_pricefreeExact USDC quote for a request, without paying
generate_videopaidQuote → spend-guard check → pay → job_id
get_jobfreePoll status; returns video_url on success (24h link)
submit_feedbackfreeTell humans: price / missing feature / quality / bug / cheaper source

Setup

You need a dedicated spending wallet with a few USDC on Base (8453). Never use your main wallet — see the 5-minute getting-started guide.

Claude Code

bash
claude mcp add x402-video \  --env BUYER_PRIVATE_KEY=0xYOUR_SPENDING_WALLET_KEY \  -- npx -y x402-video-mcp

Claude Desktop / Cursor (JSON)

json
{  "mcpServers": {    "x402-video": {      "command": "npx",      "args": ["-y", "x402-video-mcp"],      "env": {        "BUYER_PRIVATE_KEY": "0xYOUR_SPENDING_WALLET_KEY"      }    }  }}

Without BUYER_PRIVATE_KEY the free tools (catalog, quotes, job polling, feedback) still work; only generate_video requires the wallet.

Feedback (free)

Agents can report product needs without paying:

submit_feedback({  message: "Need wait_for_job so I don't burn tokens polling",  category: "feature",  suggested_price_usd: 0.5})

Categories: pricing | feature | quality | bug | source | other. Also available as raw HTTP: POST https://api.x402video.com/feedback.

Environment variables

VarDefault
BUYER_PRIVATE_KEY—Spending wallet key (USDC on Base). Required only for generate_video.
MAX_USD_PER_CALL5Hard spend guard — generate_video refuses quotes above this. Raise MAX_USD_PER_CALL for long 1080p Standard jobs (up to $9.82).
GATEWAY_URLhttps://api.x402video.comPoint at another gateway instance.

How payment works

  1. The tool POSTs your request unpaid; the gateway answers HTTP 402 with the exact USDC amount for that request (a free quote).
  2. If the quote is within MAX_USD_PER_CALL, the request is retried with an x402 payment header — an EIP-3009 signature, so the buyer pays no gas.
  3. You get a job_id; generation takes ~2 minutes (p50). Poll get_job, download video_url within 24h.

Develop

bash
npm installnpm run buildBUYER_PRIVATE_KEY=0x... node dist/index.js   # speaks MCP over stdio

Content policy

Hard red lines (rejected pre-payment, never charged): content involving minors, real-person likeness/deepfakes. Sexually explicit content and graphic violence are rejected.

MIT. Independent gateway — not affiliated with or endorsed by model vendors.

來源：README.md，提交 6fb0691

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分