createTask Max1

The method creates a task for solving the selected captcha type. The parameters include client authentication data, typed task information, and, if necessary, additional parameters.

Method address: https://captcha69.com/createTask
Request format: JSON POST

Request Parameters

Parameter	Type	Required
`clientKey`	String	Required
`task`	Task object	Required
`callbackUrl`	String	Optional

`clientKey`

Your unique account API key.

`task`

Task data object. See the list of available task types in the Supported Captcha Types section.

`callbackUrl`

Web address for sending the captcha task result. Data is sent by POST request. The content is identical to the response of the getTaskResult method. The content of the response is not checked and you should accept the request within 2 seconds, after which the connection will be closed.

Example with callbackUrl

{
  "clientKey": "max1_YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2Task",
    "websiteURL": "https://example.com/captcha-page",
    "websiteKey": "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  },
  "callbackUrl": "https://yourwebsite.com/callback"
}

Request Examples

Solving normal captcha with an image (ImageToTextTask)

{
  "clientKey": "max1_YOUR_API_KEY",
  "task": {
    "type": "ImageToTextTask",
    "body": "BASE64_BODY_HERE!"
  }
}

Solving ReCaptcha2 (RecaptchaV2Task)

{
  "clientKey": "max1_YOUR_API_KEY",
  "task": {
    "type": "RecaptchaV2Task",
    "websiteURL": "https://example.com/captcha-page",
    "websiteKey": "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

Response Structure

Parameter	Type	Description
`errorId`	Integer	Error identifier. 0 - no errors, task created successfully, task ID is in `taskId`. 1 - error, see `errorCode`.
`errorCode`	String	Error code. See the error list for details.
`taskId`	Integer	Task ID for further use in the getTaskResult method.

Response Examples

Response without error

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

Response with error

{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
  "errorDescription": "Account authorization key not found in the system or has incorrect format",
  "taskId": 0
}

Error Codes

Error Code	Description
`ERROR_KEY_DOES_NOT_EXIST`	Account authorization key not found in the system or has incorrect format.
`ERROR_WRONG_USER_KEY`	The `clientKey` parameter has an incorrect format.
`ERROR_KEY_NOT_AUTHORIZED`	The specified API key is not authorized.
`ERROR_ZERO_BALANCE`	Account has zero balance.
`ERROR_NO_SLOT_AVAILABLE`	No available workers to process your task. Try again later.
`ERROR_RECAPTCHA_INVALID_SITEKEY`	The ReCaptcha site key is invalid.
`ERROR_RECAPTCHA_INVALID_DOMAIN`	The ReCaptcha domain is invalid.
`ERROR_TASK_ABSENT`	The `task` parameter is missing or empty.
`ERROR_TASK_NOT_SUPPORTED`	The task type is not supported.
`ERROR_IMAGE_BODY_NOT_CORRECT`	The image body is not correct or missing.