shenhao-stu/ohmycaptcha

这是什么？

核心功能

• 01兼容 YesCaptcha 风格的 createTask、getTaskResult 和 getBalance 接口。
• 02使用 Playwright 与 Chromium 处理 reCAPTCHA v2/v3、hCaptcha 和 Cloudflare Turnstile。
• 03借助视觉模型对 HCaptcha、reCAPTCHA v2、FunCaptcha、AWS 等图片分类验证码进行识别。
• 04同时支持通过 SGLang、vLLM 部署的本地模型和兼容 OpenAI 接口的云端模型。
• 05任务异步执行，调用方轮询结果，内存中保留 10 分钟。
• 06支持本地、Render 和 Hugging Face Spaces 部署。

适用场景

• 为 flow2api 或其他兼容 YesCaptcha 协议的工具提供验证码识别后端。
• 在获得授权的安全测试中，检验网站 reCAPTCHA、hCaptcha 或 Turnstile 集成的表现。
• 将验证码识别部署在自有基础设施上，替代付费的第三方服务。

快速上手

1. 1

   创建并激活虚拟环境

   python -m venv .venv && source .venv/bin/activate
2. 2

   安装 Python 依赖

   pip install -r requirements.txt
3. 3

   安装 Playwright 的 Chromium 浏览器

   playwright install --with-deps chromium
4. 4

   设置模型环境变量和 CLIENT_KEY，然后启动服务

   python main.py

使用前须知

• !任务存储在内存中，TTL 为 10 分钟，重启后会丢失。
• !基于浏览器的求解依赖运行环境、IP 信誉和目标网站行为。
• !图像分类质量取决于所用的视觉模型。
• !并未复刻商业验证码服务的全部功能，minScore 参数也不会生效。

标签

常见问题

ohmycaptcha 是什么？

可自托管的验证码识别服务，提供兼容 YesCaptcha 的异步 API，结合 Playwright 与多模态模型。 OhMyCaptcha 是一个可自托管的验证码识别服务，提供与 YesCaptcha 风格客户端兼容的 createTask、getTaskResult 和 getBalance 接口。服务基于 FastAPI 构建，可作为 flow2api 等需要该协议的系统的第三方验证码求解器直接接入。

ohmycaptcha 可以免费使用吗？用的什么许可证？

ohmycaptcha 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

ohmycaptcha 还在维护吗？

超过半年未提交。ohmycaptcha 最近一次提交是在 2026年3月9日。

ohmycaptcha 适合用来做什么？

为 flow2api 或其他兼容 YesCaptcha 协议的工具提供验证码识别后端。 在获得授权的安全测试中，检验网站 reCAPTCHA、hCaptcha 或 Turnstile 集成的表现。 将验证码识别部署在自有基础设施上，替代付费的第三方服务。

ohmycaptcha 怎么安装和运行？

创建并激活虚拟环境: python -m venv .venv && source .venv/bin/activate 安装 Python 依赖: pip install -r requirements.txt 安装 Playwright 的 Chromium 浏览器: playwright install --with-deps chromium 设置模型环境变量和 CLIENT_KEY，然后启动服务: python main.py

在哪里获取 ohmycaptcha？

源代码和安装说明在 GitHub 上：https://github.com/shenhao-stu/ohmycaptcha