v4 Bypass Solution

The GeeTest v4 solver endpoint takes the captcha's captcha_id and returns the validation payload for slide, AI, puzzle, and icon challenges, so you never render or solve the widget yourself.

How the solution works

To bypass a GeeTest v4 captcha:

1. Parse the captcha_id and (optionally) kind from the captcha. The kind defaults to ai but may vary based on the captcha type (for example slide, puzzle, icon).

2. Send the captcha_id to our API, and retrieve the response.

Endpoint

GET https://geetest.takionapi.tech/v4

Parameters:

• captcha_id (required): The captcha's captcha_id.

• kind (optional): The type of captcha to solve (defaults to "slide").

• proxy (optional): Proxy for solving (format: ip:port or ip:Port:mail:password).

Example Response:

{
  "response": {
    "captcha_id": "fcd636b4514bf7ac4143922550b3008b",
    "lot_number": "e4c0b946b91c4aeabbc343b9a0f048ca",
    "pass_token": "4856da4c49ca...3edea00d688e",
    "gen_time": "1725490466",
    "captcha_output": "Vt45iXQep...=="
  }
}

In order to access any of our endpoint you'll need a valid API Key, either join our discord for a trial or puchase a plan

Solve GeeTest v4

post

Solves a GeeTest v4 captcha from its captcha_id and returns the validated solution (lot_number, pass_token, gen_time, captcha_output) under response. GET with query params also works.

Authorizations

x-api-keystringRequired

Body

captcha_idstringRequired

The GeeTest v4 captcha_id from the target.

kindstringOptional

Challenge kind.

Default: aiExample: ai

proxystringOptional

Proxy in ip:port or ip:port:user:pass format (optional).

Example: 1.2.3.4:8000:user:pass

Other propertiesanyOptional

Responses

200

The solved v4 payload under response.

application/json

Other propertiesanyOptional

400

Missing input.

application/json

401

Authentication or quota failure — HTTP 401 with an error message.

application/json

500

The captcha could not be solved, or an unexpected error.

application/json

post/v4

POST /v4 HTTP/1.1
Host: geetest.takionapi.tech
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "captcha_id": "text",
  "kind": "ai",
  "proxy": "1.2.3.4:8000:user:pass",
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

{
  "response": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "ANY_ADDITIONAL_PROPERTY": "anything"
}