Aliyun Captcha 2.0 Solver API

The Solverify Aliyun Captcha 2.0 Solver API creates a browser-based task for Aliyun Captcha 2.0 and returns the Aliyun verification payload in solution.value. Use this task type when you have the page URL, SceneId, identity prefix, region, and proxy details.

Request Parameters

Field	Required	Description
`clientKey`	Yes	Your API key.
`websiteURL`	Yes	Full URL of the page where the Aliyun Captcha 2.0 widget is displayed.
`websiteKey`	Yes	The `SceneId` value passed to `initAliyunCaptcha({ SceneId: "..." })`.
`prefix`	Yes	Identity Prefix from the Aliyun Captcha console, the subdomain portion of `<prefix>.captcha-open.aliyuncs.com`.
`region`	No	Aliyun Captcha region. Allowed values: `sgp`, `cn`. Default: `sgp`.
`proxyType`	Yes	Proxy type. Only `http` is accepted.
`proxyAddress`	Yes	Proxy IP address or hostname.
`proxyPort`	Yes	Proxy port. Numeric string, 1 to 5 digits.
`proxyLogin`	No	Proxy username.
`proxyPassword`	No	Proxy password.

The proxy should be the same IP used for any follow-up business request made with the resulting token. Aliyun's device token is bound to the network path that generated it.

Create Task Example

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "aliyun",
    "websiteURL": "https://h5.rsnvip7.fun/",
    "websiteKey": "s7r707fw8",
    "prefix": "zir9dtu",
    "region": "sgp",
    "proxyType": "http",
    "proxyAddress": "1.1.1.1",
    "proxyPort": "8080",
    "proxyLogin": "username",
    "proxyPassword": "password"
  }
}

Create Response

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

Result Example

{
  "errorId": 0,
  "status": "completed",
  "solution": {
    "value": "{\"sceneId\":\"s7r707fw8\",\"certifyId\":\"Zfx3380sm1\",\"deviceToken\":\"U0dfV0VCIzM3OTVkMjgyNDJhMTE2MTli...\",\"data\":\"JRMlgg1EDSM6Rg4LRQRHM1ICsZIZfhFXaGEBckRX...\"}"
  },
  "errorCode": null,
  "errorDescription": null
}

In most integrations, parse solution.value as JSON before submitting it to the target business endpoint. Depending on storage/deserialization, solution.value may also be returned as a structured object.

Timeout

Aliyun tasks can run for up to about 210 seconds before timing out internally.

Next Steps

After creating an Aliyun Captcha 2.0 task, poll the Get Task Result API with the returned taskId. For validation and capacity errors, see Solverify API Error Codes.