본문으로 건너뛰기
Windscribe

VPN API를당신의VPN API를당신의 에이전트에게.

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

자율 에이전트를 위한 가드레일

에이전트가 악성 링크나 주입된 지시를 따르더라도, 알려진 악성코드, 피싱, 봇넷 도메인은 조회할 수 없어요.

데이터도, 노이즈도 줄이기

광고와 트래커를 차단하면 페이지가 가벼워져서, 에이전트가 불필요한 요소에 쓰는 토큰과 대역폭이 줄어들어요.

키별로 API에서 설정

새 키는 악성코드 차단이 켜진 상태로 시작해요. 목록은 언제든 다음으로 바꿀 수 있어요:

PUT /vpn/wireguard/settings

프라이버시와 제어

가입할 것도, 유출될 것도 없어요

신원

계정 제로

API는 여러분이 누구인지 절대 묻지 않아요. 에이전트가 WireGuard 키 쌍을 생성하면, 공개 키가 곧 신원의 전부예요. 개인 키는 기기를 떠나지 않고, 연결을 관리하는 모든 요청은 이 키로 서명되니 연결만큼이나 안전하게 보관하세요.

이메일비밀번호카드세션wg_pubkey ✓
x402 결제

에이전트가 알아서 결제해요

Base 기반 USDC로, 개방형 x402 표준을 통해 요청마다 정산돼요. 결제 페이지도, 저장된 카드도 없고, 결제를 재시도해도 이중 청구되지 않아요.

표준 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)
API 살펴보기9개 엔드포인트, 요청 및 응답 필드, 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는 무엇인가요?

Windscribe WireGuard VPN 액세스를 WireGuard 공개 키에 직접 판매하는 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 리졸버, 사전 공유 키, 엔드포인트 포트를 반환하므로 wg-quick을 포함한 모든 WireGuard 클라이언트로 연결할 수 있어요.

Windscribe는 무엇을 저장하나요?

공개 키, 생성된 사전 공유 키, 만료일, ROBERT 필터, 그리고 각 결제의 상품 정보, 상태, 정산 트랜잭션 해시예요. Windscribe는 지갑 주소를 저장하지 않지만, 정산 내역은 Base에 공개되어 결제한 지갑이 드러나요.

WireGuard 키가 이미 사용 중이면 어떻게 되나요?

Windscribe 계정이나 파트너에 속한 키는 돈이 이동하기 전에 wireguard_key_exists로 거부돼요. 새 키를 생성해서 다시 시도하세요.

어떤 서버를 사용할 수 있나요?

액세스가 활성 상태인 동안 GET /vpn/wireguard/locations가 반환하는 프리미엄 WireGuard 위치예요. 고정 IP 서버는 포함되지 않아요.