跳到主要内容
Windscribe

VPN API,专为你的 AIVPN API,专为你的 AI 智能体打造。

给你的 AI 智能体一个专属的 WireGuard VPN。 它们只需一次 API 调用即可用 USDC 购买,通过 DNS 过滤屏蔽恶意域名,而且完全不需要账户。

智能体请从 llms.txt 开始。 基础 URL https://api.windscribe.com/vpn

使用场景

智能体用自己的 VPN 做什么

智能体代你在开放网络上行动。在这些任务中,私密且可控的连接至关重要。

  • 隐私

    私密浏览

    网站只能看到 Windscribe 的 IP,永远看不到你的家庭或办公网络。

  • 地区测试

    从另一个国家看

    像当地人一样查看当地价格和搜索结果。

  • 安全

    保护任何网络

    为酒店 Wi-Fi、机器人和边缘设备提供加密的 WireGuard 隧道。

  • 平台

    每位客户一条隧道

    每个工作区或任务对应一个密钥和一个期限。无需管理任何账户。

使用 ROBERT 进行 DNS 过滤

限定智能体能访问的范围

屏蔽恶意软件和钓鱼域名,让智能体无法被引导过去;或屏蔽广告和跟踪器,减少干扰和流量消耗。一次 API 请求即可切换某个密钥的列表,由隧道的 DNS 解析器强制执行。

过滤列表
DNS 查询9 个中已屏蔽 3 个
  1. search.engine.example
  2. shocking.headlines.example
  3. miner.hashpool.example
  4. sync.tracker.example广告 + 跟踪器已拦截
  5. shop.retailer.example
  6. odds.casino.example
  7. c2.botnet.example恶意软件已拦截
  8. ads.network.example广告 + 跟踪器已拦截
  9. cdn.images.example

PUT /vpn/wireguard/settings{"robert": ["malware","ads"]}→ wireguard.dns = 10.255.255.3

为自主智能体设置护栏

即使智能体点开了恶意链接或执行了被注入的指令,也无法解析已知的恶意软件、钓鱼或僵尸网络域名。

更少流量,更少干扰

屏蔽广告和跟踪器让页面更轻量,智能体在无用内容上花费的 token 和带宽也更少。

按密钥通过 API 设置

新密钥默认开启恶意软件拦截。可随时通过以下方式更改列表:

PUT /vpn/wireguard/settings

隐私与控制

无需注册,也无可泄露

身份

零账户

API 从不询问你是谁。你的智能体生成一对 WireGuard 密钥,公钥就是全部身份。私钥永远不会离开本机,所有管理连接的请求都由它签名,所以请像保护连接本身一样保护好它。

邮箱密码银行卡会话wg_pubkey ✓
x402 支付

你的智能体自己付款

通过开放的 x402 标准,使用 Base 上的 USDC 按请求结算。没有结账页面,无需绑卡,重试付款也绝不会重复扣费。

标准 WireGuard

兼容任何 WireGuard 客户端

用你的密钥签名的请求会返回地址、DNS 解析器和预共享密钥,套用一个模板就能生成 wg-quick 配置。

API 完全掌控

续期、迁移或终止访问

购买更多时长、将访问权限迁移到新密钥或立即撤销,每项操作只需一次签名请求。

智能体如何用 x402 购买 VPN

从零到隧道,只需四步

普通 HTTP 加开放的 x402 支付标准。任何 x402 v2 客户端都无需自定义代码即可付款。

  1. 402

    请求期限

    发送 WireGuard 公钥和月数,返回准确的价格、网络和收款方。

    POST /vpn/wireguard

  2. x402

    支付报价

    签署一份 USDC 转账授权,并附上它再次发送同一请求。

    PAYMENT-SIGNATURE: …

  3. 201

    生成配置

    签名请求会返回地址、DNS 解析器和预共享密钥。从位置列表中选择一个出口。

    GET /vpn/wireguard/locations

  4. WG

    连接

    用任意 WireGuard 客户端建立隧道,并设置任务所需的过滤器。

    wg-quick up ./windscribe.conf

价格

统一价格,USDC 支付

通过 x402 以 Base 上的 USDC 支付。没有订阅,也不会自动续费:用同一密钥再次购买即可增加时长,最多可提前 12 个月。付款概不退还。

月付$0
年付省 $39$0

面向开发者和智能体的文档

智能体起步所需的一切

OpenAPI 规范描述了每个端点。llms.txt 是给智能体的精简版。

把这段交给你的智能体
阅读 https://windscribe.com/vpn-api/llms.txt。
在这台机器上创建一对 WireGuard 密钥,用 x402 为它购买一个月的 Windscribe VPN 访问权限,开启恶意软件和广告屏蔽,然后为最近的位置写一份 wg-quick 配置。私钥必须保留在这台机器上。
概览
基础 URL
https://api.windscribe.com/vpn
发现
GET /vpn
付款
x402 v2,exact 方案,Base 上的 USDC
认证
使用 WireGuard 密钥签名的请求(wg-xeddsa-v1)
探索 API9 个端点、请求和响应字段,以及 cURL、Python 和 JavaScript 代码打开
POST/vpn/wireguard

Buy time for a WireGuard key

Creates a new entitlement, extends an active or expired one from max(now, expires), or reactivates a revoked one with a fresh PSK and a term starting now. Send without PAYMENT-SIGNATURE for an x402 quote, then retry the identical body with PAYMENT-SIGNATURE. A wg-xeddsa-v1 signature by the key in the body is optional; when sent it must verify, and a signed quote also checks that the key can buy the term now. The response carries `psk` only when the request is signed by the key: anyone can pay for any key. Retrying the same PAYMENT-SIGNATURE never pays twice.

签名可选x402 · Base 上的 USDCbuyWireGuardTime

请求头

请求头
必填
说明
PAYMENT-SIGNATURE
否
Base64 x402 v2 PaymentPayload. Omit to receive a quote. Its authorization's validBefore must be at most maxTimeoutSeconds, plus 30 seconds of clock skew, from now.
X-Windscribe-WireGuard-Key
否
Part of the optional purchase signature.
Content-Digest
否
Part of the optional purchase signature.
Signature-Input
否
Part of the optional purchase signature.
Signature
否
Part of the optional purchase signature.

请求体 · application/json

字段
类型
说明
wg_pubkey必填
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
months必填
integer
123456712

响应

Payment settled and time bought

字段
类型
说明
pubkey必填
string
A WireGuard X25519 public key as `wg pubkey` prints it: canonical base64 of 32 bytes, u below 2^255 - 19 (top bit clear), and not a small-order point.
status必填
string
activeexpiredrevoked
expires必填
integer
Unix seconds; access ends exactly then.
ipv4必填
string
ipv6必填
string
robert必填
string[]
malwareadssocialporngamblingfakenewscompetitorscryptominers
wireguard必填
object
[Interface] values; the [Peer] comes from a locations group and node.
wireguard.address必填
string
Interface IPv4 address with prefix, derived from the public key.
wireguard.address_v6必填
string
Interface IPv6 address with prefix, derived from the public key.
wireguard.dns必填
string
Windscribe resolver for the current ROBERT filters.
wireguard.allowed_ips必填
"0.0.0.0/0, ::/0"
wireguard.endpoint_port必填
443
purchasable_terms必填
integer[]
Terms that a purchase would accept now without exceeding the 12-month cap.
123456712
psk
string
WireGuard preshared key for the [Peer] section. Only when the request is signed by the key; otherwise read it with a signed GET /vpn/wireguard.
success必填
1
payment_id必填
string | null
Null when rotate moved an active entitlement.
settlement_reference必填
string | null
Base transaction hash of the settlement.

所示字段位于 data 内。

请求
# 1. Quote. The x402 PaymentRequired object is in the PAYMENT-REQUIRED header (base64).
curl -si https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'

# 2. Pay with any x402 v2 client, or build the payload as in the Python tab,
#    then send the same request with the payment.
curl -s https://api.windscribe.com/vpn/wireguard \
  -H 'Content-Type: application/json' \
  -H "PAYMENT-SIGNATURE: $PAYMENT" \
  -d '{"wg_pubkey":"<your WireGuard public key>","months":1}'
响应示例 · 201
{
  "data": {
    "pubkey": "j0DFrbaPJWJK5bIU6nZ6bslNgp09e14a0bpvPiE4KF8=",
    "status": "active",
    "expires": 1797207705,
    "ipv4": "100.88.12.34",
    "ipv6": "fd54:4::5c0c:2a2",
    "robert": [
      "malware"
    ],
    "wireguard": {
      "address": "100.88.12.34/32",
      "address_v6": "fd54:4::5c0c:2a2/128",
      "dns": "10.255.255.2",
      "allowed_ips": "0.0.0.0/0, ::/0",
      "endpoint_port": 443
    },
    "purchasable_terms": [
      1,
      2,
      3,
      4,
      5,
      6,
      7
    ],
    "psk": "EXAMPLEexampleEXAMPLEexampleEXAMPLEexample0=",
    "success": 1,
    "payment_id": "6c1f0e9a2b7d4c3e8f5a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e",
    "settlement_reference": "0xeb0c71793e4e18a80c8123e34c8f908404f4ee107d3c8dfea4c742ad73e01ccf"
  }
}
All Your Devices
Stars

给你的智能体一个专属 VPN。

用 POST /vpn/wireguard 获取报价,用 x402 付款,用 WireGuard 连接。

All Your Devices

常见问题

购买之前

什么是 Windscribe VPN API?

一个直接向 WireGuard 公钥出售 Windscribe WireGuard VPN 访问权限的 HTTP API。AI 智能体、脚本和设备无需 Windscribe 账户即可购买、使用和管理连接。

AI 智能体能自己购买 VPN 吗?

可以。智能体发送其 WireGuard 公钥和期限,收到 HTTP 402 报价,用 x402 以 USDC 付款,然后拿回 WireGuard 配置所需的值。无需任何人注册或确认。

我需要 Windscribe 账户吗?

不需要。API 从不索要邮箱、密码或会话。你的 WireGuard 公钥标识此次购买,管理它的请求则用对应的私钥签名。

如何付款?

通过 x402 v2,使用 Base 上的 USDC 付款。第一次请求会返回确切金额和收款地址;你的客户端签署一笔 USDC 转账授权,然后再次发送请求。

这是订阅吗?

不是。每次付款购买 1 到 7 个月或 12 个月的固定期限。用同一密钥再次购买即可增加时长,最多可提前 12 个月。

可以退款吗?

不可以。付款概不退还。撤销密钥会立即终止访问并放弃剩余时长;再次购买时长即可重新激活该密钥。

我能控制智能体可访问的域名吗?

可以。每个密钥都有 ROBERT DNS 过滤列表:恶意软件(含钓鱼和僵尸网络服务器)、广告 + 跟踪器、社交网络、色情、赌博、标题党、加密货币和其他 VPN。新密钥默认开启恶意软件过滤,可随时通过 PUT /vpn/wireguard/settings 更改列表。不支持自定义域名规则。

它使用哪种 VPN 协议?

WireGuard。API 会返回接口地址、DNS 解析器、预共享密钥和端点端口,因此任何 WireGuard 客户端(包括 wg-quick)都能连接。

Windscribe 会存储什么?

公钥、生成的预共享密钥、到期时间、你的 ROBERT 过滤器,以及每笔付款的产品详情、状态和结算交易哈希。Windscribe 不存储你的钱包地址,但结算记录在 Base 上公开可见,会显示付款钱包。

如果我的 WireGuard 密钥已被使用怎么办?

属于 Windscribe 账户或合作伙伴的密钥会在任何资金转移之前以 wireguard_key_exists 被拒绝。生成新密钥后重试即可。

我可以使用哪些服务器?

在访问有效期间,GET /vpn/wireguard/locations 返回的高级 WireGuard 位置。不包括静态 IP 服务器。