
Aloísio Vítor
Image Processing Expert
Publicado Oct 22, 2026
Actualizado Oct 22, 2026 · min de lectura

ImageToTextTask de CapSolver acepta datos de imagen y devuelve texto reconocido directamente; una tarea de token de reCAPTCHA usa parámetros del sitio web y tiene un contrato de resultado distinto.Elegir entre reconocimiento de imagen CAPTCHA y resolución de tokens empieza con una pregunta práctica: ¿qué espera el siguiente paso de tu aplicación? Un campo de texto puede necesitar los caracteres mostrados en una imagen. Una integración de reCAPTCHA espera un token de respuesta. Enviar el primer resultado a la segunda interfaz no funcionará, incluso cuando ambas operaciones se describan como “resolver un CAPTCHA”.
CapSolver documenta por separado las tareas de reconocimiento y de tokens. Esta guía compara sus entradas, salidas y responsabilidades de integración para que puedas elegir un punto de partida adecuado para pruebas o automatización autorizadas. No clasifica proveedores ni asume que todos los CAPTCHA pueden manejarse mediante la misma solicitud.
El reconocimiento de imagen produce una respuesta sobre el contenido de la imagen, mientras que la resolución de tokens produce un valor de respuesta para un sistema de verificación compatible.
Esas son distinciones a nivel de API. No establecen qué modelo subyacente usa un servicio ni si un navegador está involucrado internamente. Para el trabajo de integración, la distinción útil es la información que envías y el resultado que recibes.
Un CAPTCHA puede tener varias formas visibles. Algunos piden a una persona que lea caracteres distorsionados; otros muestran un desafío de selección de imágenes; otros incluso funcionan sin un rompecabezas de imagen. La presencia de una imagen por sí sola no te dice qué aceptará la aplicación como finalización.
| Punto de decisión | Reconocimiento de imagen | Resolución de tokens |
|---|---|---|
| Entrada típica | Bytes de imagen codificados como texto, más instrucciones específicas de la tarea | URL del sitio web, clave del sitio y parámetros específicos de la tarea |
| Salida típica | Caracteres reconocidos o resultados de clasificación | Un token de respuesta CAPTCHA |
| Qué debe proporcionar el llamador | La imagen correcta para el desafío actual | El tipo correcto de CAPTCHA y los parámetros de la página actual |
| Qué queda después | Usar la respuesta en el paso previsto de la aplicación y comprobar la aceptación | Entregar el token a través de la integración prevista y comprobar la aceptación |
| Incompatibilidad común | Tratar la salida de clasificación como un token de verificación | Enviar un token a un campo que espera caracteres de imagen |
Esta comparación describe contratos de tareas habituales, no un esquema universal. Lee la documentación de la tarea concreta antes de crear un único analizador de resultados.
Elige reconocimiento de imagen cuando tu flujo de trabajo tiene una imagen y necesita una respuesta definida sobre su contenido.
Por ejemplo, una prueba autorizada de una aplicación con un CAPTCHA de texto puede tener ya acceso a la imagen mostrada. El siguiente paso espera sus caracteres. Una tarea de OCR puede proporcionar ese texto, mientras que la prueba de la aplicación sigue siendo responsable de introducirlo y comprobar el resultado.
La referencia oficial de la tarea ImageToText requiere un body que contenga el contenido Base64 de la imagen. Una URL del sitio web es opcional para esta tarea. Proporcionar una clave del sitio sin la imagen no cumple ese requisito de entrada.
Base64 representa datos binarios usando caracteres de texto. Es una codificación, no un paso de mejora de imagen. Un CAPTCHA mal recortado o desactualizado sigue siendo inadecuado después de codificarlo.
Para ImageToTextTask, usa el contenido de la imagen sin saltos de línea ni el prefijo data:image/...;base64,, tal como especifica la referencia de la tarea. Mantén fuera de la imagen enviada al servicio el contenido de página no relacionado y la información personal.
El siguiente cuerpo de solicitud sigue el esquema oficial con un marcador explícito para la imagen. Es un ejemplo de esquema, no una resolución ejecutada: sustituye la clave y el valor de la imagen antes de usarlo con POST https://api.capsolver.com/createTask.
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ImageToTextTask",
"body": "BASE64_IMAGE_CONTENT"
}
}
Esta tarea devuelve directamente su resultado de reconocimiento. Inspecciona los campos de error antes de leer solution.text; no añadas un bucle de sondeo solo porque otra tarea de CAPTCHA lo necesite.
La clasificación de imágenes responde a una pregunta sobre una imagen en lugar de transcribir caracteres. CapSolver documenta la clasificación de imágenes de reCAPTCHA como una tarea separada con entradas de imagen y pregunta.
Una respuesta de clasificación no es una verificación de reCAPTCHA completada. Si eliges una interfaz de reconocimiento, tu aplicación aún necesita un flujo de trabajo de desafío compatible. No supongas que una lista de regiones de imagen seleccionadas puede insertarse dondequiera que una aplicación espere un token de respuesta.
Para una primera integración, escribe el resultado esperado antes de elegir un nombre de tarea. “Leer los caracteres” y “obtener una respuesta de reCAPTCHA” son requisitos distintos, incluso cuando ambos empiezan con una captura de pantalla en un ticket de soporte.
Elige resolución de tokens cuando la aplicación use una integración CAPTCHA compatible y la salida requerida sea su token de respuesta.
La referencia de la tarea reCAPTCHA v2 describe parámetros del sitio web como websiteURL y websiteKey. Estos identifican la página y la integración CAPTCHA. No son sustitutos entre sí, y la clave pública del sitio no es tu clave de API de CapSolver.
Este segundo ejemplo de esquema muestra la forma básica de una tarea reCAPTCHA v2 sin proxy. No es una solicitud ejecutada y no incluye todos los parámetros opcionales que una integración concreta pueda necesitar.
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.yourwebsite.com",
"websiteKey": "YOUR_RECAPTCHA_SITE_KEY"
}
}
Usa los valores reales de tu página permitida y el tipo de tarea documentado para esa versión de CAPTCHA. Una integración v2, v3 o Enterprise no debe seleccionarse por prueba y error con nombres de tarea no relacionados.
Con el flujo asíncrono createTask, guarda el ID de tarea devuelto y obtén el resultado de esa tarea mediante getTaskResult. Lee el campo de solución documentado para la tarea seleccionada. Evita escribir un único analizador que suponga que toda respuesta correcta contiene el mismo campo.
Canjea tu código de bono de CapSolver
Aumenta tu presupuesto de automatización al instante.
Usa el código de bono CAP26 al recargar tu cuenta de CapSolver para obtener un 5% de bono extra en cada recarga, sin límites.
Canjéalo ahora en tu Panel de CapSolver
Ambos flujos de trabajo necesitan una comprobación a nivel de aplicación después de que el solver devuelva su resultado.
Para un CAPTCHA de texto, eso puede significar confirmar que el formulario previsto aceptó los caracteres para el mismo desafío. Si la imagen se actualizó mientras se ejecutaba la solicitud, una respuesta para la imagen anterior ya no es el resultado que tu formulario actual necesita.
Para integraciones de tokens, una cadena no vacía no demuestra que la aplicación haya aceptado la solicitud. La documentación de verificación de reCAPTCHA de Google describe el paso de verificación del token en el servidor del sitio web. El secreto privado de verificación del sitio web pertenece a su servidor; un usuario del solver no debería necesitar obtener el secreto de otra persona.
De forma similar, Cloudflare requiere validación en el servidor de las respuestas de Turnstile. Estas comprobaciones del proveedor son independientes de que el solver informe de que una tarea está lista. Si administras la aplicación, inspecciona su resultado de validación. Si estás probando otro flujo de trabajo permitido, comprueba su resultado de éxito documentado sin afirmar visibilidad sobre su backend privado.
La distinción también ayuda al depurar. Registra si el fallo ocurrió durante la captura de imagen, la creación de la tarea, la obtención del resultado, la entrega del resultado o la aceptación en la aplicación. Una captura de pantalla del error final por sí sola puede no identificar qué paso requiere atención.
Para más detalles sobre los valores devueltos, consulta la explicación sobre tokens CAPTCHA y cookies. Ni una respuesta de OCR ni un token de respuesta establecen automáticamente una sesión de navegador persistente.
Elige la interfaz compatible más pequeña que proporcione el resultado que tu flujo de trabajo existente puede consumir.
Usa una tarea de reconocimiento de texto cuando el desafío sea una imagen de texto y puedas obtener legítimamente la imagen actual. Confirma la captura de imagen, la codificación, el texto devuelto y la respuesta del formulario como pasos separados. Es un encaje directo para OCR; añadir una tarea de token de sitio web no abordaría el requisito del campo de entrada.
Usa la tarea de token correspondiente cuando tengas los parámetros documentados y una ruta de integración legítima. No conviertas la presencia de un rompecabezas de imagen en un requisito para mantener un flujo de trabajo de clasificación de imágenes separado. Parte del producto CAPTCHA y del contrato de respuesta.
Haz que el agente identifique el desafío compatible y el contexto de integración disponible antes de solicitar una acción al solver. Una simple captura de pantalla no demuestra que el agente tenga la entrada de imagen correcta, la clave del sitio, el callback o la ruta de entrega del resultado. Detente ante información faltante en lugar de hacer que el modelo invente valores.
Para un flujo de trabajo de navegador establecido, una integración de navegador documentada puede manejar más parte de esa interacción. La comparación de esta guía no sustituye una prueba de integración con el cliente o navegador específico que pienses usar.
Compara compatibilidad, esfuerzo de implementación y resultados verificados en la aplicación antes de comparar el precio titular de tareas individuales.
La compatibilidad va primero: una respuesta de bajo coste no sirve si tiene el formato incorrecto para la aplicación. Después, contabiliza el trabajo que tu equipo debe mantener, como captura de imagen, estado del desafío, obtención del resultado y comprobaciones finales de aceptación. Estas responsabilidades difieren entre flujos de trabajo incluso cuando ambos usan una API HTTP.
Evalúa una pequeña muestra autorizada que refleje el tipo de CAPTCHA que realmente necesitas. Mantén las condiciones de origen lo bastante consistentes como para entender los fallos. Registra por separado los errores de tareas y los rechazos de la aplicación, y evita tratar el estado “ready” de un proveedor como tu tasa de éxito de extremo a extremo.
No deduzcas velocidad, precisión de reconocimiento ni superioridad de costes a partir de esta clasificación por sí sola. Esas son mediciones para una tarea e integración concretas, no consecuencias de las palabras “imagen” o “token”.
La respuesta esperada te da el punto de partida más claro: caracteres de imagen, salida de clasificación o un token de respuesta de verificación.
Contrasta esa respuesta con la documentación actual de la tarea, proporciona las entradas correspondientes y define cómo confirmará tu aplicación la finalización. CapSolver ofrece interfaces separadas para estas necesidades; elegir con criterio reduce incompatibilidades evitables de entrada y salida.
Prueba CapSolver con un tipo de CAPTCHA compatible en un flujo de trabajo autorizado. Empieza con un único contrato de tarea confirmado antes de ampliar tu implementación.
P: ¿El reconocimiento de imágenes CAPTCHA es lo mismo que la resolución de tokens?
No. El reconocimiento devuelve información sobre una imagen, como texto o resultados de clasificación. La resolución de tokens devuelve una respuesta para una integración CAPTCHA compatible. Selecciona la interfaz según lo que la aplicación espera a continuación.
P: ¿Puede usarse un resultado de OCR como token de reCAPTCHA?
No. Los caracteres reconocidos no son un token de respuesta de reCAPTCHA. Pertenecen a contratos de entrada y verificación distintos.
P: ¿Toda tarea de CAPTCHA necesita sondeo (polling)?
No. CapSolver documenta un resultado directo para ImageToTextTask, mientras que las tareas de token asíncronas usan un ID de tarea y obtención de resultado. Sigue el flujo documentado de la tarea seleccionada en lugar de aplicar un único bucle a todas las respuestas.
P: ¿Qué método es mejor para un agente de IA?
El mejor método es el que coincide con el desafío y la integración real del agente. Un agente que puede capturar una imagen no es automáticamente capaz de completar un flujo de trabajo basado en tokens. Verifica las entradas requeridas y el paso de entrega del resultado.
P: ¿Una respuesta correcta del solver significa que mi aplicación tuvo éxito?
No. La aplicación todavía debe aceptar la respuesta o el token y completar la acción prevista. Comprueba ese resultado por separado y mantén la automatización dentro del acceso que tienes permitido usar.

Aloísio Vítor
Image Processing Expert
Interpreting the visual signals behind web workflows.
SOBRE EL AUTOR
Soluciona el ERROR_IP_BANNED deteniendo las solicitudes repetidas y erróneas a la API de CAPTCHA, encontrando el primer error, revisando los códigos relacionados y reanudando con una prueba controlada.

Soluciona errores de proxy de CapSolver comprobando los parámetros de la tarea, la autenticación, la conectividad y la configuración de la sesión antes de volver a intentar una solicitud de CAPTCHA.
