{"id":24971,"date":"2026-08-06T10:17:14","date_gmt":"2026-08-06T10:17:14","guid":{"rendered":"https:\/\/capskip.com\/?p=24971"},"modified":"2026-08-06T10:17:14","modified_gmt":"2026-08-06T10:17:14","slug":"geetest-v3-python","status":"publish","type":"post","link":"https:\/\/capskip.com\/zh\/geetest-v3-python\/","title":{"rendered":"\u5982\u4f55\u7528 Python \u8bc6\u522b\u6781\u9a8c v3 \u5e76\u56de\u4f20"},"content":{"rendered":"

Most CAPTCHA code assumes one token in, one token out. GeeTest breaks that. A solve returns three<\/strong> values that have to be submitted together, and the challenge you fed in expires roughly sixty seconds after you fetched it. Both of those catch people out, and neither fails with a helpful message.<\/p>\n

Two inputs that behave differently<\/h2>\n\n\n\n\n\n\n
Value<\/th>\nLifetime<\/th>\n<\/tr>\n<\/thead>\n
gt<\/code><\/td>\nStatic for the site. Cache it freely<\/td>\n<\/tr>\n
challenge<\/code><\/td>\nSingle use, dead in about 60 seconds<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Both come from the site’s own GeeTest init endpoint. The gt<\/code> is effectively a site identifier. The challenge<\/code> is per attempt, and treating it as reusable is the single most common reason a GeeTest integration works in testing and falls apart under load.<\/p>\n

Setup<\/h2>\n
# Python 3.10 or newer.\npip install capskip<\/pre>\n
from capskip import CapSkip\n\nsolver = CapSkip(\n    host="127.0.0.1",\n    port=8080,\n    recaptchaTimeout=300,   # GeeTest uses this, not defaultTimeout\n)<\/pre>\n
That timeout distinction is easy to miss. defaultTimeout<\/code> only governs image CAPTCHAs; everything interactive uses recaptchaTimeout<\/code>.<\/p>\n
Solving<\/h2>\n
result = solver.geetest(\n    gt="81388ea1fc187e0c335c0a8907ff2625",\n    challenge="7cf6a8b1a2c34d5e6f7089abcdef0123",\n    url="https:\/\/example.com\/login",\n)\n\nprint(result["challenge"])\nprint(result["validate"])\nprint(result["seccode"])<\/pre>\n
Those three keys are the answer. result[\"code\"]<\/code> is populated too, but for GeeTest it holds the raw JSON string rather than something you can submit, so reaching for it out of habit produces a confusing failure.<\/p>\n
Use the challenge<\/code> that comes back, not the one you sent in. They are not always the same value.<\/p>\n
The full flow, in one place<\/h2>\n
Fetching and solving have to be adjacent. Anything slow between them risks the expiry:<\/p>\n
import time\nimport requests\nfrom capskip import CapSkip\n\nsolver = CapSkip()\nLOGIN = "https:\/\/example.com\/login"\n\n# 1. Fresh pair, cache-busted. Cached init responses hand back dead challenges.\ninit = requests.get(\n    "https:\/\/example.com\/geetest\/init",\n    params={"t": int(time.time() * 1000)},\n).json()\n\n# 2. Solve immediately. Do not queue this.\nresult = solver.geetest(gt=init["gt"], challenge=init["challenge"], url=LOGIN)\n\n# 3. Post all three together, alongside the real form fields.\nresponse = requests.post(LOGIN, data={\n    "geetest_challenge": result["challenge"],\n    "geetest_validate": result["validate"],\n    "geetest_seccode": result["seccode"],\n    "username": "...",\n    "password": "...",\n})<\/pre>\n
The cache-busting timestamp matters more than it looks. GeeTest init endpoints are often cached by a CDN or a proxy, and a cached response hands you a challenge that was already spent.<\/p>\n
Those three field names are the usual GeeTest v3 convention, but a site can rename them. Check the real form before assuming.<\/p>\n
Doing several at once<\/h2>\n
The trap here is batching wrong. Fetching a pile of challenges and then solving them all guarantees the later ones expire before their turn. Fetch and solve inside the same task:<\/p>\n
import asyncio\nfrom capskip import AsyncCapSkip\n\nasync def solve_one(solver, url):\n    init = await fetch_pair(url)          # your own fetch, awaited\n    return await solver.geetest(\n        gt=init["gt"], challenge=init["challenge"], url=url,\n    )\n\nasync def main():\n    solver = AsyncCapSkip()\n    return await asyncio.gather(*[solve_one(solver, u) for u in urls])\n\nasyncio.run(main())<\/pre>\n
Python is the only CapSkip SDK where AsyncCapSkip<\/code> is a real async client rather than an alias, so this genuinely runs solves in parallel.<\/p>\n
When it fails<\/h2>\n
from capskip import (\n    ValidationException, NetworkException, ApiException, TimeoutException,\n)\n\ntry:\n    result = solver.geetest(gt=gt, challenge=challenge, url=page_url)\nexcept ValidationException:\n    pass   # missing gt or challenge\nexcept NetworkException:\n    pass   # CapSkip is not running\nexcept ApiException:\n    pass   # usually a challenge that expired before the solve finished\nexcept TimeoutException:\n    pass   # exceeded recaptchaTimeout<\/pre>\n
In practice most GeeTest failures arrive as ApiException<\/code> and mean the challenge died. The fix is fetching later, not retrying with the same pair, because a spent challenge never becomes valid again.<\/p>\n
Frequently asked questions<\/h2>\n
\n\n
Why is result[“code”] not usable?<\/h3>\n<\/summary>\n
Because the answer is three values rather than one. code<\/code> keeps the raw JSON for completeness while the SDK expands the useful parts into challenge<\/code>, validate<\/code> and seccode<\/code>. Submit those three.<\/p>\n<\/details>\n
\n\n
Can I cache the challenge between runs?<\/h3>\n<\/summary>\n
No. It is single use and expires in about a minute. The gt<\/code> is safe to cache; the challenge never is.<\/p>\n<\/details>\n
\n\n
Does this cover GeeTest v4?<\/h3>\n<\/summary>\n
The geetest<\/code> method targets v3, the slide puzzle built around a gt<\/code> and challenge<\/code> pair. v4 changed the parameter model, so check the current API documentation<\/a> before assuming the same call applies.<\/p>\n<\/details>\n
Summary<\/h2>\n
Fetch gt<\/code> and challenge<\/code> immediately before solving with a cache-busted request, call geetest<\/code>, then post challenge<\/code>, validate<\/code> and seccode<\/code> together. Use the returned challenge rather than your input, and never batch challenge fetching ahead of solving.<\/p>\n
Other languages are on the GeeTest solver<\/a> page, the wider Python surface on the Python CAPTCHA solver<\/a> page, and there is a live puzzle on our GeeTest v3 demo<\/a>. CapSkip handles captcha bypass<\/a> locally, so solve volume is free.<\/p>\n","protected":false},"excerpt":{"rendered":"
\u6781\u9a8c\u8fd4\u56de\u7684\u662f\u4e09\u4e2a\u503c\u800c\u975e token\uff0c\u4f60\u6240\u4f9d\u636e\u7684\u6311\u6218\u7ea6\u4e00\u5206\u949f\u540e\u5931\u6548\u3002\u4e0b\u9762\u662f\u80fd\u5e94\u5bf9\u8fd9\u4e00\u70b9\u7684 Python \u6d41\u7a0b\u3002<\/p>","protected":false},"author":1,"featured_media":24970,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"Solve GeeTest v3 in Python | CapSkip","rank_math_description":"GeeTest returns three values in Python, not one token, and the challenge expires in about a minute. Here is the full flow and the mistake that breaks it.","rank_math_focus_keyword":"solve geetest in python","footnotes":""},"categories":[70],"tags":[],"class_list":["post-24971","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-captcha"],"_links":{"self":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24971","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/comments?post=24971"}],"version-history":[{"count":1,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24971\/revisions"}],"predecessor-version":[{"id":24991,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24971\/revisions\/24991"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/media\/24970"}],"wp:attachment":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/media?parent=24971"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/categories?post=24971"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/tags?post=24971"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}