Every task moves through a predictable lifecycle — from creation to a retrievable result.Documentation Index
Fetch the complete documentation index at: https://docs.funbypass.com/llms.txt
Use this file to discover all available pages before exploring further.
Task Flow
Task Creation
You send a
POST /createTask request. The server validates your API key, task parameters, proxy format, and checks your balance or package quota. If everything is valid, a task ID (UUID) is returned and the task is queued for processing.Validation
The server performs deep validation:
- API key and account status
- Task type must be
FunCaptchaTask - Site key must be a valid UUID
- Proxy format and port validation
- Thread limit check
Session Initialization
A session is created through your proxy. The system detects the proxy’s geolocation to set the correct timezone and language, then generates the initial session token.
Immediate Completion Check
If the session token contains
sup=1, no interactive step is required and the result token is returned immediately. This is the fastest path.Interactive Processing
If an interactive step is required, the system parses the flow type, variant, and number of rounds, then processes each round until completion or timeout.
Task Statuses
| Status | Description |
|---|---|
created | Task accepted and queued |
processing | Task is running |
ready | Task completed (check errorId for success/failure) |
failure | Task failed with an error |
Timeouts
| Phase | Timeout |
|---|---|
| Total task | 300 seconds |
| Processing phase | 120 seconds |
| Result TTL | 120 seconds after completion |
Balance & Refunds
Balance-based (FUN-) keys are charged when a task starts processing and automatically refunded if the task fails. See Authentication for billing details.