createTask

Creates a task and returns taskId at once. The price is held and charged only if the task is solved.

本節內容以英文顯示。

本頁內容

Request
The task object
Example
Response
Billing
Limits
Errors
Try it

Endpoint

POST https://neurocaptcha.com/createTask

Creates a task and answers at once with taskId. Get the solution with getTaskResult or receive it at callbackUrl.

Request#

參數說明

clientKey string必填: Your API key.
task object必填: The task: its type and parameters (below).
callbackUrl string: Public http(s) URL for a signed webhook when the task is finished. Private addresses are rejected.
softId integer: Your application id in the developer program: you get a share of the spending of clients who use your application.
languagePool string: Accepted for compatibility with Anti-Captcha; ignored.

The task object#

Which fields matter depends on the task type; unknown fields are ignored.

參數說明

type string必填: Task type, see task types.
websiteURL string必填: Full address of the page where the reCAPTCHA is shown: http(s), up to 2048 characters. The page, not the address of the reCAPTCHA iframe.
websiteKey string必填: Site key: the data-sitekey attribute of the widget or the k parameter of the anchor request in DevTools → Network. Up to 256 characters, no spaces.
isInvisible boolean: true for invisible reCAPTCHA v2 (the widget has data-size="invisible" and shows only a badge). Default false.
recaptchaDataSValue string: The data-s value if the page passes one (some Google services do). Up to 4096 characters.
pageAction string: The action the page passes to grecaptcha.execute(sitekey, {action: …}), e.g. login. Up to 128 characters.
minScore number: Minimum score of the token from 0 to 1, usually 0.3, 0.7 or 0.9.
enterprisePayload object: Extra parameters of grecaptcha.enterprise.render / execute, e.g. {"s": "…"}, up to 8 KiB of JSON. If recaptchaDataSValue or pageAction is empty, the s and action keys are used instead.
isEnterprise boolean: Compatibility flag of Anti-Captcha clients: true turns a regular reCAPTCHA type into its Enterprise twin (solved and billed as Enterprise). Prefer the Enterprise task types.
apiDomain string: Domain the widget is loaded from: www.google.com (default) or www.recaptcha.net.
userAgent string: User-Agent of the browser that will submit the token, up to 512 characters. It is returned in solution.userAgent.
cookies string: Cookies of the target site for the solving browser: name=value; name2=value2, up to 8192 characters. Stored encrypted.
proxyType string: http (default), https, socks4 or socks5.
proxyAddress string僅限代理類型: IP address or host name of the proxy. Private and local addresses are rejected.
proxyPort integer僅限代理類型: Proxy port, 1–65535.
proxyLogin string: Proxy login, up to 256 characters. Stored encrypted.
proxyPassword string: Proxy password, up to 256 characters. Stored encrypted.

Example#

import requests

response = requests.post("https://neurocaptcha.com/createTask", json={
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "RecaptchaV2TaskProxyless",
        "websiteURL": "https://www.google.com/recaptcha/api2/demo",
        "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    },
}, timeout=30)
print(response.json())

Response#

Success

{
  "errorId": 0,
  "taskId": 7781
}

Error

{
  "errorId": 22,
  "errorCode": "ERROR_TASK_ABSENT",
  "errorDescription": "websiteURL must be an absolute http(s) URL."
}

Billing#

The task price (after your volume discount) is held on createTask. getBalance shows the balance without held amounts.
The money is charged only when the task becomes ready. A failed or expired task releases the hold — it costs nothing.
Test keys are free.
Got a token the site rejected? reportIncorrectRecaptcha within 24 h returns the money.

Limits#

30 createTask per second per key (bursts up to 60) — above it ERROR_TOO_MUCH_REQUESTS.
200 tasks in progress per key (can be changed per key) — above it ERROR_NO_SLOT_AVAILABLE.
Request body up to 1 MiB.

Errors#

errorId	errorCode	When
1	`ERROR_KEY_DOES_NOT_EXIST`	wrong or revoked key
2	`ERROR_NO_SLOT_AVAILABLE`	too many tasks of the key in progress
10	`ERROR_ZERO_BALANCE`	the available balance is below the task price
11	`ERROR_IP_NOT_ALLOWED`	the IP is not in the key's allowlist
14	`ERROR_NO_SUCH_METHOD`	the body is not valid JSON
22	`ERROR_TASK_ABSENT`	`task` is missing or a field is invalid — see `errorDescription`
23	`ERROR_TASK_NOT_SUPPORTED`	unknown or disabled task type
55	`ERROR_ACCOUNT_SUSPENDED`	the account is suspended
90	`ERROR_INTERNAL`	temporary failure, retry
91	`ERROR_TOO_MUCH_REQUESTS`	rate limit of the key or IP
92	`ERROR_SPENDING_LIMIT`	daily or monthly cap of the key reached

Try it#

線上測試

從你的瀏覽器送出真實的 createTask 請求，接著每 2 秒呼叫一次 getTaskResult，並原樣顯示 JSON 回應。

API 金鑰

請使用測試金鑰：完全免費，幾秒內就會回傳模擬的 TEST_ token。金鑰不會被儲存。取得金鑰

任務類型

websiteURL

websiteKey

recaptchaDataSValue · 選填

isInvisible（隱形 reCAPTCHA）

更多參數

userAgent

apiDomain

callbackUrl（Webhook）

可以送出

請求會送往本站自己的網址；金鑰與回應只會留在你的瀏覽器中。

請求

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2TaskProxyless",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"
  }
}

回應

createTask

// …