Перейти к основному содержимому
Windscribe

VPN APIдля вашихVPN APIдля ваших агентов.

Дайте своим ИИ-агентам собственный WireGuard VPN. Они покупают его за USDC одним вызовом API, блокируют вредоносные домены с помощью DNS-фильтрации и обходятся без аккаунта.

Агентам: начинайте с llms.txt. Базовый URL https://api.windscribe.com/vpn

Сценарии

Зачем агентам собственный VPN

Агенты действуют в открытом интернете от вашего имени. Вот задачи, где важно приватное и управляемое соединение.

  • Приватность

    Приватный веб-серфинг

    Сайты видят IP Windscribe, а не вашу домашнюю или офисную сеть.

  • Гео-тестирование

    Взгляд из другой страны

    Проверяйте местные цены и результаты поиска так, как их видят жители этой страны.

  • Безопасность

    Защита любой сети

    Гостиничный Wi-Fi, роботы и периферийные устройства получают зашифрованный туннель WireGuard.

  • Платформы

    Отдельный туннель для каждого клиента

    Один ключ и срок на рабочее пространство или задачу. Никаких аккаунтов, которыми нужно управлять.

DNS-фильтрация с ROBERT

Ограничьте, куда может попасть ваш агент

Блокируйте домены с вредоносным ПО и фишингом, чтобы агента нельзя было на них направить, или отсекайте рекламу и трекеры, чтобы снизить шум и расход трафика. Один API-запрос переключает списки для ключа, а DNS-резолвер туннеля применяет их.

Списки фильтров
DNS-запросыЗаблокировано 3 из 9
  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

Страховка для автономных агентов

Даже если агент перейдёт по вредоносной ссылке или выполнит внедрённую инструкцию, он не сможет разрешить известные домены вредоносного ПО, фишинга или ботнетов.

Меньше трафика, меньше шума

Блокировка рекламы и трекеров облегчает страницы, поэтому агенты тратят меньше токенов и трафика на мусор.

Настройка для каждого ключа через API

Для новых ключей блокировка вредоносного ПО включена сразу. Списки можно изменить в любой момент командой:

PUT /vpn/wireguard/settings

Приватность и контроль

Не нужно регистрироваться — нечему утечь

Идентификация

Никаких аккаунтов

API никогда не спрашивает, кто вы. Ваш агент генерирует пару ключей WireGuard, и открытый ключ — это и есть вся идентификация. Закрытый ключ никогда не покидает машину, и каждый запрос на управление соединением подписывается им, поэтому храните его так же надёжно, как само соединение.

эл. почтапаролькартасессияwg_pubkey ✓
Платежи x402

Ваш агент платит сам

USDC в сети Base с расчётом по каждому запросу через открытый стандарт x402. Никакой страницы оформления заказа, никакой сохранённой карты, а повторная попытка платежа никогда не списывает деньги дважды.

Стандартный WireGuard

Работает с любым клиентом WireGuard

Запрос, подписанный вашим ключом, возвращает адрес, DNS-резолвер и предварительный общий ключ (preshared key), так что для конфигурации wg-quick достаточно одного шаблона.

Полный контроль через API

Продлевайте, переносите или прекращайте доступ

Докупите время, перенесите доступ на новый ключ или немедленно отзовите его — каждое действие выполняется одним подписанным запросом.

Как агент покупает VPN через x402

От нуля до туннеля за четыре шага

Обычный 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

Оплата в USDC в сети Base через x402. Без подписки и автопродления: купите снова с тем же ключом, чтобы добавить время, максимум на 12 месяцев вперёд. Платежи не возвращаются.

Помесячно$0
ГодовойЭкономия $39$0

Документация для разработчиков и агентов

Всё, что нужно агенту для старта

Спецификация OpenAPI описывает каждый эндпоинт. llms.txt — краткая версия для агентов.

Передайте это своему агенту
Прочитай https://windscribe.com/vpn-api/llms.txt.
Создай пару ключей WireGuard на этой машине, купи для неё один месяц доступа к Windscribe VPN через x402, включи блокировку вредоносного ПО и рекламы, затем напиши конфигурацию wg-quick для ближайшей локации. Храни закрытый ключ на этой машине.
Коротко
Базовый URL
https://api.windscribe.com/vpn
Обнаружение
GET /vpn
Оплата
x402 v2, схема exact, USDC в сети Base
Аутентификация
Запросы подписываются ключом 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 · USDC в сети BasebuyWireGuardTime

Заголовки

Заголовок
Обязательный
Описание
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?

HTTP API, который продаёт доступ к WireGuard VPN от Windscribe напрямую для открытого ключа WireGuard. ИИ-агенты, скрипты и устройства могут покупать, использовать соединение и управлять им без аккаунта Windscribe.

Может ли ИИ-агент купить VPN самостоятельно?

Да. Агент отправляет свой открытый ключ WireGuard и срок, получает расчёт цены с HTTP 402, оплачивает его в USDC через x402 и получает обратно значения для конфигурации WireGuard. Человеку не нужно ни регистрироваться, ни что-либо подтверждать.

Нужен ли мне аккаунт Windscribe?

Нет. API никогда не запрашивает email, пароль или сессию. Ваш открытый ключ WireGuard идентифицирует покупку, а запросы на управление ею подписываются соответствующим закрытым ключом.

Как оплатить?

В USDC в сети Base через x402 v2. Первый запрос возвращает точную сумму и адрес получателя; ваш клиент подписывает авторизацию перевода USDC и отправляет запрос повторно.

Это подписка?

Нет. Каждый платёж покупает фиксированный срок от 1 до 7 или 12 месяцев. Купите снова с тем же ключом, чтобы добавить время, максимум на 12 месяцев вперёд.

Можно ли вернуть деньги?

Нет. Платежи не возвращаются. Отзыв ключа немедленно прекращает доступ, и оставшееся время сгорает; повторная покупка времени снова активирует ключ.

Могу ли я контролировать, к каким доменам обращается мой агент?

Да. У каждого ключа есть списки DNS-фильтров ROBERT: Вредоносное ПО (включая серверы фишинга и ботнетов), Реклама и трекеры, Соцсети, Порно, Азартные игры, Кликбейт, Криптовалюты и Другие VPN. У новых ключей включён фильтр Вредоносное ПО, а PUT /vpn/wireguard/settings меняет списки в любое время. Собственные правила для доменов не поддерживаются.

Какой VPN-протокол используется?

WireGuard. API возвращает адрес интерфейса, DNS-резолвер, предварительный общий ключ и порт эндпоинта, поэтому подключиться может любой клиент WireGuard, включая wg-quick.

Что хранит Windscribe?

Открытый ключ, сгенерированный предварительный общий ключ, дату окончания, ваши фильтры ROBERT, а для каждого платежа — данные о продукте, статус и хеш транзакции расчёта. Windscribe не хранит адрес вашего кошелька, но расчёт публично виден в сети Base и показывает кошелёк плательщика.

Что, если мой ключ WireGuard уже используется?

Ключ, принадлежащий аккаунту Windscribe или партнёру, отклоняется с ошибкой wireguard_key_exists ещё до списания средств. Сгенерируйте новый ключ и попробуйте снова.

Какие серверы я могу использовать?

Премиум-локации WireGuard, которые возвращает GET /vpn/wireguard/locations, пока ваш доступ активен. Серверы со статическими IP не входят.