PRODUCT TEST WORKSPACE

VK Captcha

Captcha verification product

VK_CAPTCHA

02 / REQUEST

Request preview

POST /api/validator/create.cgi

{
  "productCode" : "VK_CAPTCHA",
  "adapter" : {
    "image" : "BASE64_IMAGE",
    "steps" : [ 5, 19, 14, 0 ]
  }
}

03 / RESULT

Response example

EXAMPLE

Task ID —

{
  "code" : 0,
  "msg" : "Success",
  "data" : {
    "taskId" : "11111111-1111-4111-8111-111111111111",
    "productCode" : "VK_CAPTCHA",
    "state" : "SUCCEEDED",
    "solution" : {
      "best_step" : 2,
      "solution" : [ 5, 19 ],
      "answer" : "EXAMPLE_VK_FORMATTED_ANSWER",
      "preview" : "BASE64_PREVIEW"
    }
  }
}

Illustrative response; not a live task result. Replace all request placeholders before submitting.

Solution fields are not documented yet. This example shows the response envelope only.

Read data.solution after state becomes SUCCEEDED. The solution fields depend on the product; other states may return an empty object.

04 / API REFERENCE

VK Captcha · API

For task creation and queries, send the API key in the apiKey HTTP header. JSON request bodies contain business parameters only.

Content-Type: application/json
apiKey: YOUR_API_KEY

Result and application

MODE_SPECIFIC

Two native modes: image+steps selects the image task, returning best_step, ordered solution, answer and preview; redirectUri+userAgent+proxy selects the token task, returning solution.token. Keep modes separate. best_step is a count, not degrees; use the image answer in the VK API format or the token in its matching target session. Do not assume both modes have identical results.

Conditional workflows

HTTP submission HTTP_SUBMIT
Browser image interaction BROWSER_INTERACTION
Apply a result in the browser BROWSER_RESULT

Requirements

Prefer the product-specific (native) CAPTCHA integration over generic GRID. Identify the actual product/version and read its schema/guide before choosing. Use HTTP_SUBMIT when the target supports it, otherwise BROWSER_RESULT when the browser can apply the native result. Image grids on screen do not by themselves mean the product is GRID. Collect real inputs; missing inputs are a blocker, not permission to guess.
Apply a native result through the matching target integration: fill the expected token response field/callback, or use the returned challenge identifier and proof/answer fields together where that product requires them. Preserve the target session and bindings. Do not mix old and new challenge fields, replace only a picture, or assume the solver issues an unrelated transferable challenge/answer pair.
Collect fresh values from the same target/challenge. Respect product-specific hostname, action, challenge/session, IP, User-Agent and expiry requirements; these are not universally interchangeable. Apply returned cookies only to their matching domains.
Examples are placeholders, not runnable challenges. Documented result fields are not proof of target acceptance or a live availability test. Do not send unsupported fields.
SUCCEEDED means a solver result is available. Separately confirm that the target accepts the challenge and that the requested business operation completes. The solver cannot observe those two outcomes.

Input sources

Field	Input sources
`image`	Obtain the current challenge media from the target in the field format. For images, preserve original dimensions/order and crop to the challenge, not unrelated page content. For AUDIO, use the actual audio content.
`steps`	Ordered non-empty array of non-negative integers from the same VK captchaNotRobot.getContent response as image. This is not a maximum rotation count or degrees. Preserve the sequence exactly. Legacy strings containing a JSON integer array are accepted and normalized; a scalar such as "3" is invalid.
`redirectUri`	Read the fresh value from the current target challenge/session or its documented integration. Do not reuse a sample or a value from another challenge.
`userAgent`	Read the actual User-Agent used to obtain this challenge; preserve it when the product requires matching.
`proxyType`	Use the caller configured proxy. Supply related proxy fields together and retain the same egress when the target requires IP matching. Never invent proxy credentials.
`proxyAddress`	Use the caller configured proxy. Supply related proxy fields together and retain the same egress when the target requires IP matching. Never invent proxy credentials.
`proxyPort`	Use the caller configured proxy. Supply related proxy fields together and retain the same egress when the target requires IP matching. Never invent proxy credentials.
`proxyLogin`	Use the caller configured proxy. Supply related proxy fields together and retain the same egress when the target requires IP matching. Never invent proxy credentials.
`proxyPassword`	Use the caller configured proxy. Supply related proxy fields together and retain the same egress when the target requires IP matching. Never invent proxy credentials.

Request example

POST /api/validator/create.cgi · JSONC

{
  "productCode": "VK_CAPTCHA", // Product code matching the adapter parameters.
  "adapter": { // Product-specific parameter object.
    "image": "BASE64_IMAGE", // Base64-encoded challenge image.
    "steps": [ // Ordered non-empty array of non-negative integers from the same VK captchaNotRobot.getContent response as image. This is not a maximum rotation count or degrees. Preserve the sequence exactly. Legacy strings containing a JSON integer array are accepted and normalized; a scalar such as "3" is invalid.
      5,
      19,
      14,
      0
    ],
    "proxyLogin": "YOUR_PROXYLOGIN", // Proxy username, when authentication is required.
    "proxyPassword": "YOUR_PROXYPASSWORD" // Proxy password, when authentication is required.
  }
}

Request headers: apiKey: YOUR_API_KEY

Comments explain the fields. Copy produces valid JSON without comments.

Response example

POST /api/validator/query.cgi · JSONC

{
  "code": 0, // Business result code: 0 means success; other values indicate an error.
  "msg": "Success", // Result message; may be empty on success.
  "data": { // Response data; may be null on an error.
    "taskId": "11111111-1111-4111-8111-111111111111", // Task ID returned by task creation.
    "productCode": "VK_CAPTCHA", // Product code matching the adapter parameters.
    "state": "SUCCEEDED", // Task state: CREATED, SUBMITTING, PROCESSING, SUCCEEDED, FAILED or EXPIRED.
    "solution": { // Product answer when SUCCEEDED; empty while processing or on failure.
      "best_step": 2, // Steps or actions required to complete the verification.
      "solution": [ // Steps or actions required to complete the verification.
        5, // Product-specific answer field; use it according to the target website verification protocol.
        19 // Product-specific answer field; use it according to the target website verification protocol.
      ],
      "answer": "EXAMPLE_VK_FORMATTED_ANSWER", // Recognized text or text answer.
      "preview": "BASE64_PREVIEW" // Product-specific answer field; use it according to the target website verification protocol.
    }
  }
}

Creating a task returns its ID and initial state. Query the result or use WebSocket to receive the completed answer shown below.

Solution fields are not documented yet. This example shows the response envelope only.

Request parameters

Field	Type	Required	Description
`productCode`	string	Yes	Product code matching the adapter parameters.
`adapter`	object	Yes	Product-specific parameter object.
`adapter.image`	string	Conditional	Base64-encoded challenge image.
`adapter.steps`	string	Conditional	Ordered non-empty array of non-negative integers from the same VK captchaNotRobot.getContent response as image. This is not a maximum rotation count or degrees. Preserve the sequence exactly. Legacy strings containing a JSON integer array are accepted and normalized; a scalar such as "3" is invalid.
`adapter.redirectUri`	string	Conditional	Fresh VK token challenge redirect URL; use instead of image/steps.
`adapter.userAgent`	string	Conditional	User-Agent of the browser that obtained the challenge.
`adapter.proxyType`	string	Conditional	Proxy protocol, for example http.
`adapter.proxyAddress`	string	Conditional	Proxy hostname or IP address.
`adapter.proxyPort`	integer	Conditional	Proxy port.
`adapter.proxyLogin`	string	No	Proxy username, when authentication is required.
`adapter.proxyPassword`	string	No	Proxy password, when authentication is required.

Choose one field group below and supply every field in that group: image + steps / redirectUri + userAgent + proxyType + proxyAddress + proxyPort

Response parameters

Field	Type	Description
`code`	integer	Business result code: 0 means success; other values indicate an error.
`msg`	string	Result message; may be empty on success.
`data`	object \| null	Response data; may be null on an error.
`data.taskId`	string	Task ID returned by task creation.
`data.productCode`	string	Product code matching the adapter parameters.
`data.state`	string	Task state: CREATED, SUBMITTING, PROCESSING, SUCCEEDED, FAILED or EXPIRED.
`data.solution`	object	Product answer when SUCCEEDED; empty while processing or on failure.
`data.failure`	object \| omitted	Public diagnosis for FAILED/EXPIRED only; no raw provider messages. Follow the failure handling guide.
`data.failure.code`	string	Failure code
`data.failure.nextAction`	string	Next action
`data.solution.best_step`	integer	Steps or actions required to complete the verification.
`data.solution.solution`	array	Steps or actions required to complete the verification.
`data.solution.solution[]`	integer	Product-specific answer field; use it according to the target website verification protocol.
`data.solution.answer`	string	Recognized text or text answer.
`data.solution.preview`	string	Product-specific answer field; use it according to the target website verification protocol.

Responses

HTTP business responses contain code, msg and data; code 0 means success. WebSocket uses a separate message structure.

-1317: Invalid API key.
-1100 / -1101: Invalid or missing request parameters.
-1401: Insufficient balance. Add funds before creating a task.
-1400 / -1001: System or task creation error.

API documentation

VK Captcha

Create task

Request preview

Response example

VK Captcha · API

Request example

Response example

Request parameters

Response parameters

Responses