createTask

Создаёт задачу и сразу возвращает taskId. Цена резервируется и списывается, только если задача решена.

На этой странице

Запрос
Объект task
Пример
Ответ
Оплата
Лимиты
Ошибки
Попробовать

Метод

POST https://neurocaptcha.com/createTask

Создаёт задачу и сразу отвечает taskId. Решение забирайте через getTaskResult или получайте на callbackUrl.

Запрос#

ПараметрОписание

clientKey stringобязательный: Ваш ключ API.
task objectобязательный: Задача: type и параметры (ниже).
callbackUrl string: Публичный http(s)-адрес для подписанного вебхука по завершении задачи. Частные адреса отклоняются.
softId integer: Id вашего приложения в программе для разработчиков: вы получаете долю трат клиентов, которые работают через ваше приложение.
languagePool string: Принимается для совместимости с Anti-Captcha и игнорируется.

Объект task#

Какие поля важны, зависит от типа задачи; неизвестные поля игнорируются.

ПараметрОписание

type stringобязательный: Тип задачи, см. типы задач.
websiteURL stringобязательный: Полный адрес страницы, на которой показана reCAPTCHA: http(s), до 2048 символов. Именно страницы, а не iframe reCAPTCHA.
websiteKey stringобязательный: Ключ сайта: атрибут data-sitekey виджета или параметр k запроса anchor в DevTools → Network. До 256 символов, без пробелов.
isInvisible boolean: true для невидимой reCAPTCHA v2 (у виджета data-size="invisible", видна только плашка). По умолчанию false.
recaptchaDataSValue string: Значение data-s, если страница его передаёт (так делают некоторые сервисы Google). До 4096 символов.
pageAction string: Действие, которое страница передаёт в grecaptcha.execute(sitekey, {action: …}), например login. До 128 символов.
minScore number: Минимальный score токена от 0 до 1, обычно 0.3, 0.7 или 0.9.
enterprisePayload object: Дополнительные параметры grecaptcha.enterprise.render / execute, например {"s": "…"}, до 8 КиБ JSON. Если recaptchaDataSValue или pageAction пусты, берутся ключи s и action.
isEnterprise boolean: Флаг совместимости с клиентами Anti-Captcha: true превращает обычный тип reCAPTCHA в его Enterprise-вариант (решается и оплачивается как Enterprise). Лучше сразу используйте Enterprise-типы.
apiDomain string: Домен, с которого грузится виджет: www.google.com (по умолчанию) или www.recaptcha.net.
userAgent string: User-Agent браузера, который отправит токен, до 512 символов. Возвращается в solution.userAgent.
cookies string: Cookies целевого сайта для решающего браузера: name=value; name2=value2, до 8192 символов. Хранятся зашифрованными.
proxyType string: http (по умолчанию), https, socks4 или socks5.
proxyAddress stringдля типов с прокси: IP-адрес или имя хоста прокси. Частные и локальные адреса отклоняются.
proxyPort integerдля типов с прокси: Порт прокси, 1–65535.
proxyLogin string: Логин прокси, до 256 символов. Хранится зашифрованным.
proxyPassword string: Пароль прокси, до 256 символов. Хранится зашифрованным.

Пример#

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())

Ответ#

Успех

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

Ошибка

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

Оплата#

Цена задачи (с учётом вашей скидки за объём) резервируется при createTask. getBalance показывает баланс без зарезервированных сумм.
Деньги списываются, только когда задача становится ready. Неудачная или просроченная задача снимает резерв — она ничего не стоит.
Test-ключи бесплатны.
Сайт не принял токен? reportIncorrectRecaptcha в течение 24 ч возвращает деньги.

Лимиты#

30 createTask в секунду на ключ (всплески до 60) — сверх этого ERROR_TOO_MUCH_REQUESTS.
200 задач в работе на ключ (меняется в настройках ключа) — сверх этого ERROR_NO_SLOT_AVAILABLE.
Тело запроса — до 1 МиБ.

Ошибки#

errorId	errorCode	Когда
1	`ERROR_KEY_DOES_NOT_EXIST`	неверный или отозванный ключ
2	`ERROR_NO_SLOT_AVAILABLE`	у ключа слишком много задач в работе
10	`ERROR_ZERO_BALANCE`	доступный баланс меньше цены задачи
11	`ERROR_IP_NOT_ALLOWED`	IP не входит в список разрешённых для ключа
14	`ERROR_NO_SUCH_METHOD`	тело — не валидный JSON
22	`ERROR_TASK_ABSENT`	нет `task` или поле неверно — см. `errorDescription`
23	`ERROR_TASK_NOT_SUPPORTED`	неизвестный или выключенный тип задачи
55	`ERROR_ACCOUNT_SUSPENDED`	аккаунт заблокирован
90	`ERROR_INTERNAL`	временный сбой, повторите
91	`ERROR_TOO_MUCH_REQUESTS`	превышен лимит запросов ключа или IP
92	`ERROR_SPENDING_LIMIT`	достигнут суточный или месячный лимит трат ключа

Попробовать#

Песочница

Отправляет настоящий запрос createTask из вашего браузера, затем каждые 2 секунды вызывает getTaskResult и показывает ответы в JSON как есть.

Ключ API

Используйте test-ключ: это бесплатно, а фиктивный токен TEST_ приходит за пару секунд. Ключ нигде не сохраняется. Получить ключ

Тип задачи

websiteURL

websiteKey

recaptchaDataSValue · необязательно

isInvisible (невидимая reCAPTCHA)

Дополнительные параметры

userAgent

apiDomain

callbackUrl (вебхук)

Готово к отправке

Запросы идут на адрес этого же сайта; ключ и ответы остаются в вашем браузере.

Запрос

POST /createTask

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

Ответ

createTask

// …