TextRecognition
Read the text in a CAPTCHA image with automated OCR models. Covers the request schema, an example and each provider's price per 1,000.
TextRecognition reads the text in a CAPTCHA image with recognition models and returns it in solution.text. For images that need a person, such as colour rules or special instructions, use HumanRecognition.

Send the image
imageBase64: the image encoded as base64. Adata:image/...;base64,prefix is stripped for you. Providers limit the format and size of the image: for example, 2Captcha accepts JPEG, PNG and GIF up to 100 kB and 1000 px on a side. Check the provider's documentation.websiteURL: the page the CAPTCHA appears on. Providers that read it use it to improve accuracy.module: optional. Selects a recognition model on a specific provider, such ascommon, the CapSolver default. Modules differ between providers and are not interchangeable, and not every provider reads the field. Omit it unless you know the module name on the provider you route to.
Check Provider stats for live success rates and solve times before you pick a provider.
Supported Providers
| Provider | Price per 1,000 | Routing |
|---|---|---|
CapSolver | $0.40 | |
CapMonster | $0.30 | |
Multibot | $0.12 | |
Solverify | $0.10 | |
SCTG | $0.017 | |
VoidCaptcha | $1.00 |
Request Schema
| Field | Type | Required | Description |
|---|---|---|---|
clientKey* | string | Yes | Your API key. Create one in a workspace of the AnySolver dashboard. Example: |
task* | object | Yes | The task body. Required fields depend on the task type. See Tasks for per-task schemas. View task properties |
settings | object | No | Per-request settings for routing, Auto Retry, Auto Fallback, proxy reuse, response statistics and detailed analytics. Each field overrides the API key's value. See Routing modes. View settings reference |
Task Object Properties
The task field accepts an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
type* | Yes | ||
imageBase64* | string | Yes | Base64-encoded captcha image containing text to recognize. Example: |
websiteURL* | URL | Yes | Page URL where the captcha appears. Providers that read it use it to improve recognition accuracy. Example: |
module | string | No | Provider-specific recognition module, such as common (the CapSolver default). Modules are not cross-compatible between providers and not every provider reads this field. See the provider documentation for the available values. Example: |
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "TextRecognition",
"imageBase64": "/9j/4AAQSkZJRgABA...",
"websiteURL": "https://example.com/login"
}
}Optional fields are not guaranteed across providers
Response Schema
| Field | Type | Required | Description |
|---|---|---|---|
status* | Yes | Task status: "processing", "ready", or "failed". Example: | |
errorId* | Yes |
Example: | |
taskId | string | No | Unique identifier returned when the task was created. Example: |
errorCode | No | Machine-readable error code. Example: | |
errorDescription | string | No | Human-readable error message with resolution hints. Example: |
cost | number | No | Actual cost charged for this task in USD. Example: |
taskType | No | The type of CAPTCHA task to solve. Example: | |
provider | No | Provider that handled this task. While processing, the provider currently solving it. Example: | |
solution | object | No |
Solution Object Properties
The solution field contains an object with the following properties:
| Field | Type | Required | Description |
|---|---|---|---|
text* | string | Yes | Recognized text from the captcha image. Example: |
raw* | Record<string, unknown> | Yes | Raw provider response data for advanced use cases. |