Getting Started

Thiết lập và xác thực khóa API CaptchaAI

Mọi yêu cầu API CaptchaAI đều yêu cầu khóa API. Hướng dẫn này bao gồm cách lấy khóa, xác thực yêu cầu, kiểm tra số dư và giữ an toàn cho thông tin xác thực của bạn.

Lấy khóa API của bạn

  1. Tạo tài khoản tạicaptchaai.com
  2. Đăng nhập vào bảng điều khiển của bạn
  3. Điều hướng đến Cài đặt API hoặc Tài khoản
  4. Sao chép khóa API của bạn - nó trông giống như: abc123def456...
  5. Thêm tiền vào số dư của bạn (bắt đầu từ $1)

Xác thực

Mọi lệnh gọi API đều bao gồm khóa của bạn dưới dạng tham số key:

Gửi CAPTCHA

GET https://ocr.captchaai.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=SITE_KEY&pageurl=URL

Thăm dò kết quả

GET https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=get&id=TASK_ID

Kiểm tra số dư

GET https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=getbalance

Ví dụ về mã

Python

import requests
import os

# Load from environment variable (recommended)
API_KEY = os.environ.get("CAPTCHAAI_API_KEY")

# Check balance
balance = requests.get("https://ocr.captchaai.com/res.php", params={
    "key": API_KEY,
    "action": "getbalance"
})
print(f"Balance: ${balance.text}")

# Submit a CAPTCHA
resp = requests.get("https://ocr.captchaai.com/in.php", params={
    "key": API_KEY,
    "method": "userrecaptcha",
    "googlekey": "6Le-wvkS...",
    "pageurl": "https://example.com"
})
print(f"Response: {resp.text}")

Node.js

const axios = require("axios");

const API_KEY = process.env.CAPTCHAAI_API_KEY;

// Check balance
const balance = await axios.get("https://ocr.captchaai.com/res.php", {
  params: { key: API_KEY, action: "getbalance" },
});
console.log(`Balance: $${balance.data}`);

// Submit a CAPTCHA
const resp = await axios.get("https://ocr.captchaai.com/in.php", {
  params: {
    key: API_KEY,
    method: "userrecaptcha",
    googlekey: "6Le-wvkS...",
    pageurl: "https://example.com",
  },
});
console.log(`Response: ${resp.data}`);

cURL

# Check balance
curl "https://ocr.captchaai.com/res.php?key=YOUR_API_KEY&action=getbalance"

# Submit reCAPTCHA v2
curl "https://ocr.captchaai.com/in.php?key=YOUR_API_KEY&method=userrecaptcha&googlekey=SITE_KEY&pageurl=https://example.com"

Bảo mật khóa API

Sử dụng biến môi trường

Không bao giờ mã hóa khóa API của bạn trong mã nguồn:

# ❌ Bad — key in source code
API_KEY = "abc123def456"

# ✅ Good — key from environment
API_KEY = os.environ["CAPTCHAAI_API_KEY"]

Đặt biến:

# Linux/macOS
export CAPTCHAAI_API_KEY="abc123def456"

# Windows PowerShell
$env:CAPTCHAAI_API_KEY = "abc123def456"

# Windows CMD
set CAPTCHAAI_API_KEY=abc123def456

Sử dụng tệp .env

Để phát triển, hãy sử dụng tệp .env:

# .env
CAPTCHAAI_API_KEY=abc123def456
# Python
from dotenv import load_dotenv
load_dotenv()
API_KEY = os.environ["CAPTCHAAI_API_KEY"]
// Node.js
require("dotenv").config();
const API_KEY = process.env.CAPTCHAAI_API_KEY;

Thêm .env vào .gitignore của bạn để ngăn chặn việc xác thực thông tin đăng nhập:

# .gitignore
.env

Xoay phím thường xuyên

Nếu bạn nghi ngờ một khóa bị xâm phạm:

  1. Đăng nhập vào bảng điều khiển CaptchaAI của bạn
  2. Tạo khóa API mới
  3. Cập nhật các biến môi trường của bạn
  4. Thu hồi chìa khóa cũ

Phản hồi lỗi

phản hồi Ý nghĩa hành động
ERROR_WRONG_USER_KEY Khóa API không hợp lệ Kiểm tra phím cho lỗi chính tả
ERROR_KEY_DOES_NOT_EXIST Không tìm thấy chìa khóa Xác minh khóa từ bảng điều khiển
ERROR_ZERO_BALANCE Không có tiền Thêm số dư
ERROR_IP_NOT_ALLOWED Hạn chế IP đang hoạt động Thêm IP của bạn vào danh sách được phép
IP_BANNED Quá nhiều lần thử khóa không hợp lệ Đợi 5 phút; sửa chìa khóa của bạn

Câu hỏi thường gặp

Tôi có cần một khóa khác cho mỗi loại CAPTCHA không?

Không. Một khóa API hoạt động cho tất cả các loại CAPTCHA và tất cả các điểm cuối API.

Có giới hạn tốc độ đối với lệnh gọi API không?

CaptchaAI cho phép tỷ lệ yêu cầu cao. Đối với khối lượng rất cao (100K+/day), hãy liên hệ với bộ phận hỗ trợ để có dung lượng chuyên dụng.

Tôi có thể sử dụng cùng một khóa cho nhiều dự án không?

Vâng. Một khóa hoạt động trên tất cả các dự án và máy chủ của bạn. Để thanh toán riêng, hãy tạo tài khoản bổ sung.

Hướng dẫn liên quan

  • CaptchaAI Bắt đầu nhanh
  • Định dạng phản hồi API
  • Gọi lại và bỏ phiếu
Os comentários estão desativados para este artigo.

Postagens relacionadas

Troubleshooting CAPTCHA tự động hóa trình duyệt không thành công nhưng API vẫn hoạt động: Hướng dẫn gỡ lỗi
Hướng dẫn thực hành về trình duyệt tự động hóa CAPTCHA không thành công nhưng API vẫn hoạt động: Hướng dẫn gỡ lỗi, với các nguyên nhân phổ biến, các bước chẩn đ...

Hướng dẫn thực hành về trình duyệt tự động hóa CAPTCHA không thành công nhưng API vẫn hoạt động: Hướng dẫn gỡ...

Apr 29, 2026
Tutorials Xây dựng quy trình thử nghiệm tự động với CaptchaAI
Hướng dẫn từng bước để xây dựng quy trình thử nghiệm tự động với Captcha AI, với các ví dụ có thể sử dụng lại trực tiếp và quy trình làm việc Captcha AI rõ ràng...

Hướng dẫn từng bước để xây dựng quy trình thử nghiệm tự động với Captcha AI, với các ví dụ có thể sử dụng lại...

Apr 30, 2026
Reference Tính bền vững phiên trình duyệt cho luồng QA CAPTCHA của bạn
Duy trì phiên trình duyệt qua nhiều bước trong kiểm thử QA CAPTCHA trên staging của bạn để giảm gián đoạn và tăng độ tái lập.

Duy trì phiên trình duyệt qua nhiều bước trong kiểm thử QA CAPTCHA trên staging của bạn để giảm gián đoạn và t...

Apr 30, 2026