English Français العربية

x402 Video — AI Video Generation (pay-per-call, no account)

السجل الرسمي الوسائط والتصميم

Pay-per-call AI video generation (Seedance text-to-video) via x402. USDC on Base, no API key.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package x402-video-mcp
Claude Code 
claude mcp add x402-video-ai-video-generation-pay-per-c -e 'BUYER_PRIVATE_KEY=<your buyer_private_key>' -e 'MAX_USD_PER_CALL=<MAX_USD_PER_CALL>' -e 'GATEWAY_URL=<GATEWAY_URL>' -- npx -y x402-video-mcp@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "x402-video-ai-video-generation-pay-per-c": {
            "command": "npx",
            "args": [
                "-y",
                "x402-video-mcp@0.1.3"
            ],
            "env": {
                "BUYER_PRIVATE_KEY": "<your buyer_private_key>",
                "MAX_USD_PER_CALL": "<MAX_USD_PER_CALL>",
                "GATEWAY_URL": "<GATEWAY_URL>"
            }
        }
    }
}

متغيرات البيئة

  • BUYER_PRIVATE_KEY سري Spending wallet private key (USDC on Base). Only required for the paid generate_video tool; quotes and polling work without it.
  • MAX_USD_PER_CALL Hard spend guard in USD — generate_video refuses quotes above this (default 5).
  • GATEWAY_URL Alternate gateway instance (default https://api.x402video.com).

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. x402-video MCP server
  2. Tools
  3. Setup
  4. Environment variables
  5. How payment works
  6. Develop
  7. Content policy

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: ~$0.45 for a 5s 720p clip, custom 4–15s up to 1080p with optional audio ($0.13–$4.62). 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
claude mcp add x402-video \
  --env BUYER_PRIVATE_KEY=0xYOUR_SPENDING_WALLET_KEY \
  -- npx -y x402-video-mcp
Claude Desktop / Cursor (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.
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

npm install
npm run build
BUYER_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.

الأسئلة الشائعة

ما هو x402 Video — AI Video Generation (pay-per-call, no account)؟

Pay-per-call AI video generation (Seedance text-to-video) via x402. USDC on Base, no API key.

كيف أثبّت x402 Video — AI Video Generation (pay-per-call, no account)؟

يعمل على جهازك. في Claude Code: claude mcp add x402-video-ai-video-generation-pay-per-c -e 'BUYER_PRIVATE_KEY=<your buyer_private_key>' -e 'MAX_USD_PER_CALL=<MAX_USD_PER_CALL>' -e 'GATEWAY_URL=<GATEWAY_URL>' -- npx -y x402-video-mcp@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج x402 Video — AI Video Generation (pay-per-call, no account) إلى مفتاح API؟

نعم. يتطلب BUYER_PRIVATE_KEY، وتضبطها في إعداداته.

هل x402 Video — AI Video Generation (pay-per-call, no account) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون x402 Video — AI Video Generation (pay-per-call, no account)؟

ينشره x402-video. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.