# YesCaptcha Docs

> YesCaptcha es una API de reconocimiento de captchas. Con una sola interfaz JSON resuelve reCAPTCHA, hCaptcha, Cloudflare Turnstile, FunCaptcha, AWS WAF y captchas de imagen, cobra por tarea y reembolsa los puntos automáticamente si el reconocimiento falla o se agota el tiempo.

These pages are machine-translated from Chinese; the Chinese version prevails.

- Home: https://docs.yescaptcha.com/es/index.md
- OpenAPI 3.1: https://docs.yescaptcha.com/openapi.json
- Data (JSON): https://docs.yescaptcha.com/data/task-types.json, https://docs.yescaptcha.com/data/error-codes.json, https://docs.yescaptcha.com/data/vip-levels.json
- Full text: https://docs.yescaptcha.com/es/llms-full.txt

## Primeros pasos

- [Introducción](https://docs.yescaptcha.com/es/getting-started/introduction.md): Qué es YesCaptcha. Resuelve reCAPTCHA, hCaptcha, Turnstile, FunCaptcha y captchas de imagen mediante una API o una extensión del navegador, con cobro por tarea y reembolso automático de puntos en las tareas fallidas.
- [Inicio rápido](https://docs.yescaptcha.com/es/getting-started/quickstart.md): Envía tu primera solicitud a YesCaptcha en 5 minutos: crea tu cuenta, copia tu ClientKey, recarga saldo y reconoce un captcha de imagen con curl, Python o Node.js (ImageToTextTaskOcrBase, síncrono, 2 puntos por solicitud).
- [Endpoints](https://docs.yescaptcha.com/es/getting-started/endpoints.md): Los dos endpoints de la API de YesCaptcha: el global api.yescaptcha.com y el de China cn.yescaptcha.com. Solo HTTPS POST con JSON; crea y consulta una tarea en el mismo endpoint.
- [Facturación y reembolsos](https://docs.yescaptcha.com/es/getting-started/billing.md): Cómo cobra YesCaptcha: 1,000 puntos = ¥1, según el tipo de tarea; las tareas fallidas o con tiempo agotado se reembolsan automáticamente, las solicitudes que devuelven error no se cobran; el saldo debe ser mayor a 10 puntos; los reportes de fallo de reconocimiento de imágenes se reembolsan tras unas 24 horas.

## Referencia de la API

- [Solicitudes y respuestas](https://docs.yescaptcha.com/es/api/overview.md): Convenciones comunes de la API de YesCaptcha. POST con JSON, autenticación con ClientKey, formato de respuesta con errorId, tareas síncronas y asíncronas, consulta periódica (polling) cada 5 segundos, timeout de 110 segundos, resultados guardados unos 10 minutos e idioma de los mensajes según Accept-Language.
- [createTask — crear una tarea](https://docs.yescaptcha.com/es/api/create-task.md): POST /createTask crea una tarea de reconocimiento de captcha. Parámetros de la solicitud (clientKey, task, softID), orden de las comprobaciones, las tareas asíncronas devuelven taskId y las síncronas devuelven solution directamente; el saldo debe ser superior a 10 puntos.
- [getTaskResult — obtener el resultado](https://docs.yescaptcha.com/es/api/get-task-result.md): POST /getTaskResult consulta el resultado de una tarea asíncrona: consulta cada 5 segundos, sigue esperando con processing, lee solution con ready y detén la consulta periódica si hay un error; una tarea tarda hasta unos 110 segundos, el resultado se conserva unos 10 minutos y las consultas no cobran puntos.
- [getBalance: consultar el saldo](https://docs.yescaptcha.com/es/api/get-balance.md): POST /getBalance consulta el saldo de la cuenta (puntos, 1,000 puntos = ¥1) y los saldos de participación del desarrollador y de recompensa por referidos. No cobra puntos y sirve para verificar tu clientKey.
- [getSoftID — consultar tu ID de desarrollador](https://docs.yescaptcha.com/es/api/get-soft-id.md): POST /getSoftID devuelve tu ID de desarrollador (softID) y la participación del desarrollador acumulada. Incluye el softID en las solicitudes createTask que envía tu software para otros usuarios y obtendrás una participación.
- [report — reportar resultados](https://docs.yescaptcha.com/es/api/report.md): POST /report informa si el resultado de una tarea fue correcto; reporta tanto los éxitos como los fallos con honestidad. Los fallos de tipos de reconocimiento de imágenes reportados dentro de 1 hora desde la creación de la tarea se liquidan con reembolso tras unas 24 horas.
- [useragent — obtener el User-Agent](https://docs.yescaptcha.com/es/api/useragent.md): GET https://api.yescaptcha.com/useragent devuelve el User-Agent del navegador que se recomienda usar (texto plano). El campo userAgent de las tareas de hCaptcha solo acepta este valor.
- [Códigos de error](https://docs.yescaptcha.com/es/api/errors.md): Significado y forma de resolver todos los códigos de error de la API de YesCaptcha: formato de la solicitud, cuenta y saldo, tareas simultáneas y pausas, resultado de la tarea, parámetros del sitio, imágenes, proxy y servidor. Las solicitudes que devuelven error no cobran puntos.
- [Límite de tareas simultáneas y pausa automática](https://docs.yescaptcha.com/es/api/rate-limits.md): Límite de tareas simultáneas de YesCaptcha (ERROR_THREADS_MAXIMUM, sin cobro de puntos y sin contar para la pausa), pausa automática por exceso de errores (100 en un minuto pausan 5 minutos, ERROR_IP_BLOCKED_5MIN) y caché de parámetros no válidos (cached).

## Tipos de tarea

- [Tipos de tarea y precios](https://docs.yescaptcha.com/es/tasks.md): Precios (en puntos; 1,000 puntos = ¥1) y modo de respuesta de todos los tipos de tarea públicos de YesCaptcha. Tokens para reCAPTCHA, hCaptcha y Turnstile, cookies para la página de verificación de Cloudflare, y resultados de reconocimiento para texto en imágenes y reconocimiento de imágenes.
- [reCAPTCHA v2](https://docs.yescaptcha.com/es/tasks/recaptcha-v2.md): Obtén tokens de reCAPTCHA v2 (casilla, invisible y Enterprise) con YesCaptcha: tipos de tarea y precios, parámetros de la solicitud, ejemplos en curl/Python/Node.js y formato del resultado.
- [reCAPTCHA v3](https://docs.yescaptcha.com/es/tasks/recaptcha-v3.md): Obtén tokens de reCAPTCHA v3 (incluida la versión Enterprise) con YesCaptcha: cómo rellenar pageAction, los tipos con puntuación fija de 0.7 y 0.9, tipos de tarea y precios, parámetros, ejemplos y resultado.
- [hCaptcha](https://docs.yescaptcha.com/es/tasks/hcaptcha.md): Obtén tokens de hCaptcha con YesCaptcha: HCaptchaTaskProxyless, HCaptchaTaskProxylessM1 y HCaptchaTask con tu propio proxy, cómo rellenar userAgent y rqdata, y cómo usar el respKey devuelto.
- [Cloudflare Turnstile](https://docs.yescaptcha.com/es/tasks/turnstile.md): Obtén tokens de Cloudflare Turnstile con YesCaptcha: TurnstileTaskProxyless, TurnstileTaskProxylessM1 y TurnstileTask con tu propio proxy, parámetros, ejemplos y formato del resultado; y en qué se diferencia de la página de verificación de Cloudflare.
- [Página de verificación de Cloudflare (5 segundos)](https://docs.yescaptcha.com/es/tasks/cloudflare-challenge.md): Supera con YesCaptcha la página de comprobación "Un momento…" de Cloudflare y obtén cookies como cf_clearance, el User-Agent y el contenido de la página. Parámetros de CloudFlareTaskS2 y CloudFlareTaskS3, requisitos del proxy, resultados, cómo usarlos y errores comunes.
- [Imagen a texto](https://docs.yescaptcha.com/es/tasks/image-to-text.md): Lee las letras y los dígitos de una imagen con YesCaptcha. ImageToTextTaskOcrBase e ImageToTextTaskMuggle devuelven el resultado de forma síncrona; ImageToTextTask e ImageToTextTaskM1 son asíncronos y admiten mayúsculas/minúsculas, solo dígitos, operaciones matemáticas y límites de longitud; hay modelos personalizados disponibles.
- [Reconocimiento de imágenes de reCAPTCHA v2](https://docs.yescaptcha.com/es/tasks/recaptcha-classification.md): Resuelve los desafíos de imágenes de reCAPTCHA v2 con YesCaptcha (ReCaptchaV2Classification): sube una imagen 3x3, 4x4 o 1x1 con el ID de la pregunta y recibe de forma síncrona las celdas que debes pulsar; precio según el tamaño de la imagen y tabla de IDs de preguntas.
- [Reconocimiento de imágenes de hCaptcha](https://docs.yescaptcha.com/es/tasks/hcaptcha-classification.md): Resuelve los desafíos de imágenes de hCaptcha con YesCaptcha (HCaptchaClassification): selección en cuadrícula 3×3, clic en una posición, arrastrar a una posición y preguntas animadas; respuesta síncrona, sin cobro de puntos cuando no se encuentra ningún objetivo.
- [Reconocimiento de imágenes de FunCaptcha](https://docs.yescaptcha.com/es/tasks/funcaptcha-classification.md): Reconoce los puzzles de imágenes de FunCaptcha (Arkose Labs) con YesCaptcha (FunCaptchaClassification). Sube la imagen del puzzle (una cuadrícula de 6 imágenes o un puzzle de flechas con dos mitades) y la pregunta en inglés, y obtén de forma síncrona qué imagen elegir; se admiten todos los tipos de puzzle.
- [Reconocimiento de imágenes AWS WAF / bCaptcha](https://docs.yescaptcha.com/es/tasks/aws-bcaptcha-classification.md): Reconoce con YesCaptcha los desafíos de imágenes en cuadrícula 3×3 de AWS WAF CAPTCHA y bCaptcha (AwsClassification, bCaptchaClassification). Sube la imagen completa y la pregunta, y recibe de forma síncrona las celdas en las que debes hacer clic.

## Extensión del navegador

- [YesCaptcha Assistant](https://docs.yescaptcha.com/es/extension.md): YesCaptcha Assistant (extensión del navegador) para Chrome y Firefox: reconoce y hace clic automáticamente en reCAPTCHA, hCaptcha, FunCaptcha, AWS WAF y otros captchas. La extensión es gratis; se cobran los puntos de las API que usa para reconocer. Enlaces de las tiendas, descarga de los paquetes y videos de instalación en Chrome, BitBrowser y Kiwi Browser.

## Guías

- [Identificar el tipo de captcha](https://docs.yescaptcha.com/es/guides/identify-captcha.md): Cómo saber qué captcha usa una página (reCAPTCHA v2, v2 invisible, v3, Enterprise, hCaptcha, y la diferencia entre Cloudflare Turnstile y la página de verificación de Cloudflare) y qué tipo de tarea de YesCaptcha usar.
- [Encontrar los parámetros de reCAPTCHA](https://docs.yescaptcha.com/es/guides/find-recaptcha-parameters.md): Cómo encontrar el websiteKey (sitekey), el websiteURL, el pageAction de v3 y la función callback de reCAPTCHA en las pestañas Network, Sources y Console de las herramientas de desarrollo, con un script de búsqueda automática.
- [Cómo encontrar los parámetros de hCaptcha](https://docs.yescaptcha.com/es/guides/find-hcaptcha-parameters.md): Cómo encontrar el websiteKey (sitekey) de hCaptcha, el websiteURL y el rqdata de la versión Enterprise: busca data-sitekey en el código fuente de la página, o las solicitudes checksiteconfig y getcaptcha en Network.
- [Encontrar los parámetros de Turnstile](https://docs.yescaptcha.com/es/guides/find-turnstile-parameters.md): Cómo encontrar el websiteKey (sitekey, empieza por 0x) y el websiteURL de Cloudflare Turnstile: busca data-sitekey o turnstile.render en el código fuente de la página, o revisa las solicitudes a challenges.cloudflare.com en Network.
- [Usar el token para completar reCAPTCHA](https://docs.yescaptcha.com/es/guides/submit-recaptcha-token.md): Qué hacer con el token de reCAPTCHA (gRecaptchaResponse): cómo funciona, enviarlo con una solicitud directa (campo g-recaptcha-response) o rellenarlo en el navegador y llamar al callback, con ejemplos completos en Python sobre la página de demostración de Google.
- [Clics simulados en reCAPTCHA v2 con reconocimiento de imágenes (Selenium)](https://docs.yescaptcha.com/es/guides/recaptcha-click-selenium.md): Usa Python, Selenium 4 y ReCaptchaV2Classification para hacer clic automáticamente en los desafíos de imágenes de reCAPTCHA v2 en el navegador: activa el captcha, lee la pregunta y las imágenes, llama a la API de reconocimiento, haz clic en las casillas y envía; código de ejemplo completo.
- [Clic en imágenes de hCaptcha con Selenium](https://docs.yescaptcha.com/es/guides/hcaptcha-click-selenium.md): Usa Python, Selenium 4 y HCaptchaClassification para resolver en un navegador real las cuadrículas 3×3 de hCaptcha: haz clic en la casilla, lee la pregunta y las 9 imágenes, llama a la API, haz clic y envía; código de ejemplo completo.

## Ejemplos de código

- [Código de ejemplo y SDK](https://docs.yescaptcha.com/es/samples.md): Código de ejemplo ejecutable de YesCaptcha (Python, Node.js, curl, C#, Easy Language) y SDK no oficiales de la comunidad (Python, Node.js, Go).
- [Python](https://docs.yescaptcha.com/es/samples/python.md): Ejemplos de YesCaptcha en Python: consultar el saldo, resolver un captcha de imagen, una clase de cliente reutilizable (crea la tarea y consulta cada 5 segundos), control de tareas simultáneas con asyncio y envío de reCAPTCHA con requests y Selenium.
- [Node.js](https://docs.yescaptcha.com/es/samples/nodejs.md): Ejemplos de YesCaptcha en Node.js (Node.js 18+ con el fetch integrado, sin dependencias). Consulta el saldo, resuelve un captcha de imagen y usa una clase de cliente reutilizable (crea la tarea y consulta el resultado cada 5 segundos).
- [C#](https://docs.yescaptcha.com/es/samples/csharp.md): Ejemplo de YesCaptcha en C# (.NET 6+, HttpClient y System.Text.Json). Consulta el saldo, crea una tarea de reCAPTCHA v2 y consulta el resultado cada 5 segundos.
- [Easy Language (易语言)](https://docs.yescaptcha.com/es/samples/easy-language.md): Ejemplos de YesCaptcha en Easy Language (易语言) aportados por usuarios. Clics en reCAPTCHA y hCaptcha, reconocimiento de imágenes de FunCaptcha y envío de token de reCAPTCHA; descargas y puntos clave para llamar a la API.

## Cuenta

- [Varios ClientKey: límites de gasto, lista blanca de IP y vencimiento](https://docs.yescaptcha.com/es/account/client-keys.md): Una cuenta de YesCaptcha puede tener hasta 20 ClientKey, todas con cargo al mismo saldo de la cuenta. Cada una puede tener su propio límite de gasto (diario, semanal, mensual o total único, con reinicio en hora de Beijing), lista blanca de IP y vencimiento, con efecto en pocos segundos.
- [Recarga y VIP](https://docs.yescaptcha.com/es/account/recharge.md): Cómo recargar en YesCaptcha (WeChat Pay, Alipay, PayPal, criptomonedas); 1,000 puntos = ¥1. La recarga acumulada te sube automáticamente de VIP 1 a VIP 10, y cada recarga posterior recibe puntos de bono.
- [Recompensas por referidos](https://docs.yescaptcha.com/es/account/referral.md): Recompensas por referidos de YesCaptcha. Los usuarios invitados obtienen un nivel VIP al crear su cuenta (tu nivel menos 1, de VIP 1 a VIP 6) y tú recibes el 20% de lo que gastan (10% cada uno cuando también aplica una participación del desarrollador). Puedes pasarlo a tu saldo o retirarlo desde ¥100 en el Panel.
- [Participación del desarrollador](https://docs.yescaptcha.com/es/account/developer.md): Participación del desarrollador de YesCaptcha. Incluye tu softID en las solicitudes que envía tu software para sus usuarios y recibe el 20% de lo que gastan (10% cada uno cuando además hay un referidor); pásala a tu saldo o retírala desde ¥100 en el Panel.

## Ayuda

- [Preguntas frecuentes](https://docs.yescaptcha.com/es/help/faq.md): Preguntas frecuentes de YesCaptcha. Si se cobran las tareas fallidas, cuánto dura un token, tasa de aprobación, reconocimiento humano o por máquina, bloqueo de cuentas, usar un ClientKey en varios lugares, qué endpoint elegir, extensión frente a API.
- [Problemas de conexión y red](https://docs.yescaptcha.com/es/help/troubleshooting.md): Qué hacer si no puedes conectarte a la API de YesCaptcha: pasos para diagnosticar Failed to establish a new connection, fallos de DNS, interferencia de software de proxy y errores SSL (Certificate has expired, SSLEOFError).
- [Contáctanos](https://docs.yescaptcha.com/es/help/contact.md): Contacta con el soporte de YesCaptcha por WeChat, QQ, WhatsApp, LINE, Telegram @yescaptcha_official o correo yescaptcha@gmail.com, de 9:00 a 21:00 UTC+8.
- [Registro de cambios del servicio](https://docs.yescaptcha.com/es/changelog.md): Cambios de YesCaptcha que afectan a los usuarios, por fecha. Tipos de tarea nuevos y retirados, reglas de cobro y reembolso, límite de tareas simultáneas y migración de la documentación. Se registra desde octubre de 2026.

## Other languages

- [简体中文](https://docs.yescaptcha.com/zh/llms.txt)
- [English](https://docs.yescaptcha.com/en/llms.txt)
- [日本語](https://docs.yescaptcha.com/ja/llms.txt)
- [한국어](https://docs.yescaptcha.com/ko/llms.txt)
- [Русский](https://docs.yescaptcha.com/ru/llms.txt)
- [Português](https://docs.yescaptcha.com/pt/llms.txt)
- [Tiếng Việt](https://docs.yescaptcha.com/vi/llms.txt)
- [Deutsch](https://docs.yescaptcha.com/de/llms.txt)
- [Français](https://docs.yescaptcha.com/fr/llms.txt)
- [Türkçe](https://docs.yescaptcha.com/tr/llms.txt)
- [Bahasa Indonesia](https://docs.yescaptcha.com/id/llms.txt)
- [ไทย](https://docs.yescaptcha.com/th/llms.txt)