x402-video

x402-video MCP 服务

让任何支持 MCP 的 Agent（Claude Code、Claude Desktop、Cursor，……）都能 生成 AI 视频并按次付费——通过 x402 protocol，使用 Base 上的 USDC。无需账户、API 密钥或信用卡。

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

由 x402video.com 提供支持：生成 5 秒、720p 视频片段约需 $0.45；自定义时长为 4–15 秒、分辨率最高为 1080p，并可选择添加音频（$0.13–$4.62）。提示词会在付款前进行筛查——遭拒的请求不会扣费。

工具

工具	费用	说明
list_skus	免费	实时产品目录和当前美元价格
get_stats	免费	公开的可靠性统计数据（成功率、p50 生成时间）
quote_price	免费	获取请求的精确 USDC 报价，无需付款
generate_video	付费	报价 → 支出限制检查 → 付款 → job_id
get_job	免费	轮询状态；成功时返回 video_url（链接有效期 24 小时）
submit_feedback	免费	告知开发者：价格／缺少的功能／质量／错误／更便宜的来源

设置

你需要一个专用支出钱包，并在 Base（8453）上存入少量 USDC。 切勿使用主钱包——请参阅 5 分钟 入门指南。

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"
      }
    }
  }
}

没有 BUYER_PRIVATE_KEY 时，免费工具（产品目录、报价、作业轮询、反馈）仍可使用； 只有 generate_video 需要钱包。

反馈（免费）

Agent 无需付费即可反馈产品需求：

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

类别：pricing | feature | quality | bug | source | other。 也可通过原始 HTTP 接口提交：POST https://api.x402video.com/feedback。

环境变量

变量	默认值
BUYER_PRIVATE_KEY	—	支出钱包密钥（Base 上的 USDC）。仅 generate_video 必需。
MAX_USD_PER_CALL	5	硬性支出限制——generate_video 会拒绝超出此金额的报价。
GATEWAY_URL	https://api.x402video.com	指向另一个网关实例。

付款方式

1. 工具会先不付款地 POST 你的请求；网关返回 HTTP 402，并给出该请求的精确 USDC 金额（免费报价）。
2. 如果报价在 MAX_USD_PER_CALL 限制内，则会在请求中加入 x402 付款标头并重试——使用 EIP-3009 签名， 因此买家无需支付 Gas 费。
3. 你会获得一个 job_id；生成大约需要 2 分钟（p50）。轮询 get_job，并在 24 小时内下载 video_url。

开发

npm install
npm run build
BUYER_PRIVATE_KEY=0x... node dist/index.js   # speaks MCP over stdio

内容政策

严格禁止的内容（付款前拒绝，绝不扣费）：涉及未成年人的内容、 真实人物肖像／深度伪造。露骨色情内容和血腥暴力内容也会被拒绝。

---

MIT。独立网关——与模型供应商无关联，也未获其认可。