Retry a failed solve automatically
A recoverable failure gets resubmitted to the same provider, up to the limit you set. Off by default; turn it on per key or per request.
How it works
When an attempt fails on a recoverable error, AnySolver resubmits the same task to the same provider rather than failing immediately. The default is 2 retries, and you can set anything from 0 to 10 on a key or in a single request.
Only refundable provider failures continue the chain. A request that was wrong to begin with, such as an invalid sitekey, is terminal on the first attempt: retrying it would just burn the same error again.
Same provider, fresh attempt
Each attempt advances to the next proxy in your list, so a banned IP does not poison the retry.
- TASK_TIMEOUT
Attempt 1
proxy #1
- PROXY_BANNED
Retry 1
proxy #2
- solved
Retry 2
proxy #3
Configure it
Set defaults on the API key, or override per request under settings.retry. Per-provider rules let a flaky vendor retry less than the rest.
{
"settings": {
"retry": {
"enabled": true,
"maxRetries": 3,
"onErrors": ["TASK_TIMEOUT", "PROXY_BANNED"],
"providerRules": {
"TwoCaptcha": { "maxRetries": 1 }
}
}
}
}What triggers a retry by default
Faults a fresh attempt can clear. Override the list with settings.retry.onErrors to narrow or widen it.
2 retries
Default. Up to 10 per provider.
same provider
Switching vendors on failure is Auto Fallback, not retry.
30 attempts
Hard ceiling across all retries and fallbacks combined.
A note on proxies
Retries rotate through the proxies you pass in task.proxy, wrapping around when the list is shorter than the attempt count. A single proxy with retry enabled would hit the same IP every time, so AnySolver rejects that combination unless you pass more proxies or set settings.allowProxyReuse to true.
When to use it
Providers that occasionally time out or return a transient 5xx. Proxy pools where individual IPs get flagged. Anywhere a second attempt is cheaper than handling the failure in your own code. Pair it with Auto Fallback when one more attempt on the same provider is not enough.
Ready to get started?
Everyone can register now. Stay in the loop with product updates and news. No spam.