{"uid":"cap_kOHQlALh0VcJvF16mWFoR","slug":"2captcha-createtask-via-paysponge-d27c3006","name":"2Captcha CreateTask via PaySponge","description":"Create a CAPTCHA solving task","url":"https://2captcha.x402.paysponge.com/createTask","method":"POST","headers":{},"bodySchema":{"type":"object","required":["task"],"properties":{"task":{"anyOf":[{"type":"object","required":["type","body"],"properties":{"body":{"type":"string","description":"Captcha image encoded as Base64. Data URI format with a `data:content/type` prefix is also supported."},"case":{"type":"boolean","default":false,"description":"Set to `true` when the result is case-sensitive."},"math":{"type":"boolean","default":false,"description":"Set to `true` when the captcha requires a calculation."},"type":{"type":"string","const":"ImageToTextTask"},"phrase":{"type":"boolean","default":false,"description":"Set to `true` when the answer should contain at least two words separated by a space."},"comment":{"type":"string","description":"Optional text instruction shown to workers."},"numeric":{"enum":[0,1,2,3,4],"type":"integer","default":0,"description":"Character-class hint: `0` no preference, `1` only numbers, `2` only letters, `3` either only numbers or only letters, `4` must contain both numbers and letters."},"maxLength":{"type":"integer","default":0,"minimum":0,"description":"Maximum answer length. `0` means no preference."},"minLength":{"type":"integer","default":0,"minimum":0,"description":"Minimum answer length. `0` means no preference."},"imgInstructions":{"type":"string","description":"Optional Base64-encoded instruction image shown to workers."}},"description":"Normal CAPTCHA task. Submit a distorted text image encoded as Base64. Supported image formats are JPEG, PNG, and GIF. Maximum file size is 100 kB and maximum image size is 1000 px on any side.","additionalProperties":false},{"type":"object","required":["type","websiteURL","websiteKey"],"properties":{"type":{"type":"string","const":"RecaptchaV2TaskProxyless"},"cookies":{"type":"string","description":"Cookies to set in the worker browser, formatted as `key1=value1; key2=value2`."},"apiDomain":{"type":"string","description":"Domain used to load the captcha, typically `google.com` or `recaptcha.net`."},"userAgent":{"type":"string","description":"Modern browser user agent string used to load the captcha."},"websiteKey":{"type":"string","description":"reCAPTCHA site key from the page's `data-sitekey` or the `k` parameter used in reCAPTCHA network requests."},"websiteURL":{"type":"string","format":"uri","description":"Full URL of the target page where the captcha is loaded. The page can require authentication because 2Captcha does not need to open it directly."},"isInvisible":{"type":"boolean","description":"Set to `true` for invisible reCAPTCHA v2 challenges."},"recaptchaDataSValue":{"type":"string","description":"Optional `data-s` value. This can be required to bypass captchas on some Google services."}},"description":"Proxyless reCAPTCHA v2 task. Suitable for most cases because 2Captcha uses its own proxy pool to solve the challenge.","additionalProperties":false},{"type":"object","required":["type","websiteURL","websiteKey","proxyType","proxyAddress","proxyPort"],"properties":{"type":{"type":"string","const":"RecaptchaV2Task"},"cookies":{"type":"string","description":"Cookies to set in the worker browser, formatted as `key1=value1; key2=value2`."},"apiDomain":{"type":"string","description":"Domain used to load the captcha, typically `google.com` or `recaptcha.net`."},"proxyPort":{"type":"integer","description":"Proxy port number."},"proxyType":{"enum":["http","socks4","socks5"],"type":"string","description":"Proxy protocol."},"userAgent":{"type":"string","description":"Modern browser user agent string used to load the captcha."},"proxyLogin":{"type":"string","description":"Optional username for proxy basic authentication."},"websiteKey":{"type":"string","description":"reCAPTCHA site key from the page's `data-sitekey` or the `k` parameter used in reCAPTCHA network requests."},"websiteURL":{"type":"string","format":"uri","description":"Full URL of the target page where the captcha is loaded."},"isInvisible":{"type":"boolean","description":"Set to `true` for invisible reCAPTCHA v2 challenges."},"proxyAddress":{"type":"string","description":"Proxy IP address or hostname."},"proxyPassword":{"type":"string","description":"Optional password for proxy basic authentication."},"recaptchaDataSValue":{"type":"string","description":"Optional `data-s` value. This can be required to bypass captchas on some Google services."}},"description":"reCAPTCHA v2 task with a caller-supplied proxy. Use this when Google service IP matching matters, such as Google Search or YouTube.","additionalProperties":false},{"type":"object","required":["type","websiteURL","websiteKey","minScore"],"properties":{"type":{"type":"string","const":"RecaptchaV3TaskProxyless"},"minScore":{"enum":[0.3,0.7,0.9],"type":"number","description":"Required score threshold."},"apiDomain":{"type":"string","description":"Domain used to load the captcha, typically `google.com` or `recaptcha.net`."},"pageAction":{"type":"string","description":"Optional reCAPTCHA action value, often taken from the page's `data-action` or the `grecaptcha.execute(..., { action })` call."},"websiteKey":{"type":"string","description":"reCAPTCHA site key from the page's `data-sitekey` or the `k` parameter used in reCAPTCHA network requests."},"websiteURL":{"type":"string","format":"uri","description":"Full URL of the target page where the captcha is loaded."},"isEnterprise":{"type":"boolean","description":"Set to `true` for reCAPTCHA Enterprise."}},"description":"Proxyless reCAPTCHA v3 task. Returns a token that can be sent in `g-recaptcha-response` or passed to a callback.","additionalProperties":false},{"type":"object","required":["type","body"],"properties":{"body":{"type":"string","description":"Captcha image encoded as Base64. Data URI format with a `data:content/type` prefix is also supported."},"type":{"type":"string","const":"RotateTask"},"angle":{"type":"integer","description":"Optional one-step rotation angle. If the UI rotates in fixed steps, divide 360 by the number of steps to compute this value."},"comment":{"type":"string","description":"Optional text instruction shown to workers."},"imgInstructions":{"type":"string","description":"Optional Base64-encoded instruction image shown to workers. Maximum file size is 100 kB."}},"description":"Rotate CAPTCHA task. Submit an image encoded as Base64 and receive the angle required to place the object properly. Supported image formats are JPEG, PNG, and GIF. Maximum file size is 600 kB and maximum image size is 1000 px on any side.","additionalProperties":false},{"type":"object","required":["type"],"properties":{"type":{"type":"string","description":"2Captcha task type identifier, for example `TurnstileTaskProxyless`, `FunCaptchaTaskProxyless`, or another upstream task type."}},"description":"Fallback schema for supported 2Captcha task types that are not documented in this local spec yet. Include the task-specific upstream fields required by that captcha type.","additionalProperties":true}],"description":"2Captcha task definition. This local spec documents Normal CAPTCHA, reCAPTCHA v2, reCAPTCHA v3, and Rotate CAPTCHA task bodies explicitly, and keeps a generic fallback for other 2Captcha task types that are not modeled locally yet."},"softId":{"type":"integer","description":"Optional software identifier from the 2Captcha software catalog."},"callbackUrl":{"type":"string","format":"uri","description":"Optional registered webhook URL that receives the captcha resolution result asynchronously."},"languagePool":{"enum":["en","rn"],"type":"string","description":"Optional worker language pool. Applicable to image-based and text-based captchas. `en` selects English-speaking workers and `rn` selects Russian-speaking workers."}},"description":"Task creation payload for the PaySponge wrapper. This mirrors the upstream 2Captcha request body except that the separate upstream API credential field is intentionally omitted because billing happens through x402.","additionalProperties":false},"responseSchema":{"oneOf":[{"type":"object","required":["errorId","taskId"],"properties":{"taskId":{"type":"integer","description":"Identifier of the created task."},"errorId":{"type":"integer","const":0}},"description":"Successful task creation response.","additionalProperties":false},{"type":"object","required":["errorId","errorCode","errorDescription"],"properties":{"errorId":{"type":"integer","description":"Non-zero numeric error identifier."},"errorCode":{"type":"string","description":"Stable upstream error code string."},"errorDescription":{"type":"string","description":"Human-readable upstream error description."}},"description":"2Captcha error response shape used when the upstream API cannot complete the requested operation.","additionalProperties":false}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__UMxfvkJKo6BYgBaiGFTA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a new captcha recognition task (image-to-text, reCAPTCHA v2, or other supported types) to 2Captcha via the PaySponge x402 billing wrapper, returning a taskId for polling.","exampleAgentPrompt":"Solve this image captcha for me — it's a distorted text JPEG, case-sensitive, and the answer should be letters only: [base64-encoded image string].","exampleUseCases":null,"resultDescription":"On success, returns an object with errorId=0 and a numeric taskId that the caller can use to poll for the captcha solution. On failure, returns a non-zero errorId along with a stable errorCode string and a human-readable errorDescription explaining why the task could not be created.","failureModes":["Invalid or missing task type returns errorId>0 with errorCode and errorDescription","Malformed or oversized Base64 image (>100 kB) causes task rejection","Missing required fields like websiteURL or websiteKey for reCAPTCHA tasks triggers error response","Payment failure via x402/PaySponge results in HTTP 402 before task is created","Unsupported captcha type or schema mismatch returns upstream error"],"whenToPreferThis":"Use this endpoint when you need to programmatically submit captcha-solving tasks (image-to-text, reCAPTCHA v2 proxyless, or other 2Captcha-supported types) without managing a separate 2Captcha API key, relying instead on per-call USDC billing via the x402 PaySponge wrapper. Prefer it in automated pipelines where captcha solving is a step in web scraping, form submission, or account automation workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:50.720Z","isFirstParty":false}