Fall back to the next provider automatically
When a provider keeps failing, AnySolver moves the task to the next provider in your routing order. Off by default; turn it on per key or per request.
How it works
Every request builds an ordered list of providers that can serve the task. Auto Fallback walks that list: when the current provider exhausts its retries or hits a fallback-only error, the task moves to the next candidate. The default is 2 fallbacks, settable from 0 to 20.
Auto Retry runs first. Fallback only moves on once the current provider is out of retries, or the error is one that a fresh provider can fix but the same one cannot.
Walking the candidate list
One charge rides the whole chain and reconciles to the provider that actually solved the task. If every candidate fails, the charge is refunded.
- 1PROVIDER_GLOBAL_LIMIT_REACHED
CapSolver
Attempt 1 + retries
- 2TASK_TIMEOUT
TwoCaptcha
Fallback 1
- 3solvedsettled here
AntiCaptcha
Fallback 2
Where the order comes from
The candidate list is your routing mode, applied to every eligible provider: autoCheapest orders by price, autoFastest by p90 solve time, autoMostReliable by success rate, and priority by the exact order you set. Providers you exclude are dropped up front, so fallback never reaches them.
Pinning a single provider with settings.routing.provider disables fallback: there is no next candidate to move to.
Configure it
Set defaults on the API key, or override per request under settings.fallback.
{
"settings": {
"routing": { "mode": "autoCheapest" },
"fallback": {
"enabled": true,
"maxFallbacks": 2
}
}
}What triggers a fallback by default
Everything that triggers a retry, plus the cases where the current provider simply cannot make progress and only a different one can.
Shared with retry
Fallback only
When to use it
Production workloads that must not fail when one vendor has a bad hour. High-value solves where the cost of a second provider is trivial next to a lost task. Pair it with Auto Retry to exhaust the cheap path before paying for the next one.
Ready to get started?
Everyone can register now. Stay in the loop with product updates and news. No spam.