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
- Tạo tài khoản tạicaptchaai.com
- Đăng nhập vào bảng điều khiển của bạn
- Điều hướng đến Cài đặt API hoặc Tài khoản
- Sao chép khóa API của bạn - nó trông giống như:
abc123def456... - 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:
- Đăng nhập vào bảng điều khiển CaptchaAI của bạn
- Tạo khóa API mới
- Cập nhật các biến môi trường của bạn
- 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