vpsnet.vn
Tổng quan
Proxy
VPS của tôiProxy của tôi
Mua license key
License của tôi
Mua captcha
Captcha của tôi
Ngân hàngCrypto (USDT)Thẻ cào
Hoá đơn
Lịch sử giao dịch
Thống kêLịch sử hoa hồngRút hoa hồng
Tạo website đại lýSắp có
API Cloud VPSAPI ProxySandbox APIAPI Captcha
Tạo ticket mớiTicket của tôi
Tin tức
Câu hỏi thường gặp
Liên hệ
vpsnet.vn
Đăng nhậpĐăng ký

API Captcha

Bắt đầu

Mua key ở Captcha, xem key ở Captcha của tôi. Key gửi trong body hoặc query, không dùng Bearer token.

URL gốc: https://vpsnet.vn

Dùng POST

GET vẫn chạy nhưng key nằm trên URL và dễ lộ trong log. Nên gửi POST với JSON, form hoặc multipart.

Captcha NRO POST | GET

/api/captcha/nro
Tham sốBắt buộcMô tả
key | api_key | merchant_key | apikeyCóKey NRO mua ở trang Captcha.
image | img | captchaCóẢnh base64 (có hoặc không có tiền tố data URL). Hoặc gửi file ảnh ở field file (multipart).

Ảnh png, jpeg hoặc webp, tối đa 1MB. Không nhận diện được ảnh thì không trừ lượt.

curl (JSON)
curl -X POST "https://vpsnet.vn/api/captcha/nro" \
  -H "Content-Type: application/json" \
  -d '{"key":"NRO-XXXXXXXX","image":"<ảnh base64>"}'
curl (multipart)
curl -X POST "https://vpsnet.vn/api/captcha/nro" \
  -F "key=NRO-XXXXXXXX" \
  -F "file=@captcha.png"
Python
import base64, requests

with open("captcha.png", "rb") as f:
    image = base64.b64encode(f.read()).decode()

r = requests.post(
    "https://vpsnet.vn/api/captcha/nro",
    json={"key": "NRO-XXXXXXXX", "image": image},
    timeout=20,
)
data = r.json()
if data["success"]:
    print(data["captcha"])
else:
    print(data.get("code"), data["message"])
C#
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(20) };
using var form = new MultipartFormDataContent();
form.Add(new StringContent("NRO-XXXXXXXX"), "key");
form.Add(new ByteArrayContent(File.ReadAllBytes("captcha.png")), "file", "captcha.png");

var res = await http.PostAsync("https://vpsnet.vn/api/captcha/nro", form);
Console.WriteLine(await res.Content.ReadAsStringAsync());
Thành công (200)
{ "success": true, "captcha": "abcd", "message": "" }
Lỗi
{ "success": false, "captcha": "", "message": "Key đã hết lượt.", "code": "LICENSE_OUT_OF_BALANCE" }

Turnstile POST | GET

/api/captcha/turnstile
Tham sốBắt buộcMô tả
key | api_key | merchant_key | apikeyCóKey Turnstile mua ở trang Captcha.
websiteURL | website_urlCóĐịa chỉ trang có Turnstile, bắt đầu bằng http hoặc https.
websiteKey | sitekeyKhôngSitekey của Turnstile nếu có.

Thời gian chờ

Mỗi lần giải mất tối đa 45 giây. Đặt timeout phía client từ 60 giây trở lên. Gặp 429 thì chờ rồi gửi lại, không gửi dồn.
curl
curl -X POST "https://vpsnet.vn/api/captcha/turnstile" \
  -H "Content-Type: application/json" \
  -d '{"key":"TS-XXXXXXXX","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAA..."}'
Python
import requests

r = requests.post(
    "https://vpsnet.vn/api/captcha/turnstile",
    json={
        "key": "TS-XXXXXXXX",
        "websiteURL": "https://example.com/login",
        "websiteKey": "0x4AAAAAAA...",
    },
    timeout=70,  # server chờ tối đa 45 giây, đặt timeout từ 60 giây
)
data = r.json()
print(data["token"] if data["success"] else data.get("code"))
C#
using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(70) };
var body = new StringContent(
    "{\"key\":\"TS-XXXXXXXX\",\"websiteURL\":\"https://example.com/login\"}",
    System.Text.Encoding.UTF8, "application/json");

var res = await http.PostAsync("https://vpsnet.vn/api/captcha/turnstile", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());
Thành công (200)
{ "success": true, "token": "0.xxxxx...", "message": "" }

Mã lỗi

Mã (code)HTTPÝ nghĩa
LICENSE_REQUIRED401Thiếu key.
LICENSE_INVALID401Key không tồn tại.
LICENSE_WRONG_TYPE401Key không dùng cho loại captcha này.
LICENSE_SUSPENDED / LICENSE_REVOKED401Key bị khoá hoặc đã thu hồi.
LICENSE_EXPIRED401Key thời gian đã hết hạn.
LICENSE_OUT_OF_BALANCE401Key NRO hết lượt.
INSUFFICIENT_BALANCE402Key Turnstile hết credit.
LICENSE_DAILY_LIMIT_REACHED401Key thời gian hết lượt trong ngày.
LICENSE_IP_LIMIT_REACHED401Key đã đủ số IP, reset IP trong Captcha của tôi.
CAPTCHA_UNSOLVED422Không nhận diện được ảnh, không trừ lượt.
WEBSITE_URL_REQUIRED400Turnstile thiếu hoặc sai websiteURL.
TOO_MANY_REQUESTS429Gửi quá nhiều, chờ rồi thử lại.
SOLVE_FAILED500Turnstile giải lỗi, đã hoàn credit.
SERVICE_BUSY503Máy chủ bận hoặc đang bảo trì, thử lại sau.

Giới hạn

  • Ảnh NRO tối đa 1MB.
  • Tối đa 120 yêu cầu mỗi phút cho mỗi IP.
  • Key sai quá nhiều lần sẽ bị chặn tạm thời (429).
  • Mỗi key gắn tối đa số IP của gói, reset IP trong Captcha của tôi.
  • Phản hồi luôn có success và message, lỗi có thêm code.
Điều khoản sử dụng|Bảo vệ dữ liệu cá nhân|Hoàn tiền|Khiếu nại

© 2026 vpsnet.vn