> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omocaptcha.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Tiktok3DSelectObjectWebTask
> Solve the Tiktok web captcha that asks you to click two matching 3D objects.
Selecting two matching 3D objects on the web is a common Tiktok challenge. The user must click two 3D objects with the same shape inside a background image.
## 1. Create task
### Request
`POST https://api.omocaptcha.com/v2/createTask`
| Parameter | Type | Required | Description |
| ------------------ | ------ | :------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `clientKey` | String | ✅ | Client account key |
| `task.type` | String | ✅ | `Tiktok3DSelectObjectWebTask` |
| `task.imageBase64` | String | ✅ | Captcha image encoded in base64
|
| `task.widthView` | Number | ✅ | Image width as displayed on the web page (not the original size) |
| `task.heightView` | Number | ✅ | Image height as displayed on the web page (not the original size) |
| `task.question` | String | ✅ | The captcha question (e.g. `Which of these objects are used in hoops?`) |
`widthView` and `heightView` are the **rendered** dimensions of the image on the page, not the original image size. Use the browser's Inspect element tool to get the correct values.
```bash cURL theme={null}
curl -X POST https://api.omocaptcha.com/v2/createTask \
-H "Content-Type: application/json" \
-d '{
"clientKey": "OMO_API_KEY",
"task": {
"type": "Tiktok3DSelectObjectWebTask",
"imageBase64": "BASE64_BODY_HERE",
"widthView": 340,
"heightView": 212,
"question": "Which of these objects are used in hoops?"
}
}'
```
```javascript Node.js theme={null}
const res = await fetch("https://api.omocaptcha.com/v2/createTask", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
clientKey: "OMO_API_KEY",
task: {
type: "Tiktok3DSelectObjectWebTask",
imageBase64: "BASE64_BODY_HERE",
widthView: 340,
heightView: 212,
question: "Which of these objects are used in hoops?",
},
}),
});
const data = await res.json();
console.log(data);
```
```python Python theme={null}
import requests
res = requests.post(
"https://api.omocaptcha.com/v2/createTask",
json={
"clientKey": "OMO_API_KEY",
"task": {
"type": "Tiktok3DSelectObjectWebTask",
"imageBase64": "BASE64_BODY_HERE",
"widthView": 340,
"heightView": 212,
"question": "Which of these objects are used in hoops?",
},
},
)
print(res.json())
```
```php PHP theme={null}
"OMO_API_KEY",
"task" => [
"type" => "Tiktok3DSelectObjectWebTask",
"imageBase64" => "BASE64_BODY_HERE",
"widthView" => 340,
"heightView" => 212,
"question" => "Which of these objects are used in hoops?",
],
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
```
### Response
**Success:**
```json theme={null}
{
"errorId": 0,
"taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}
```
The server returns `errorId = 0` and the `taskId` on success.
**Failure:**
```json theme={null}
{
"errorId": 1,
"errorCode": "",
"errorDescription": ""
}
```
The server returns `errorId = 1` with an `errorCode`. See [Error codes](/en/api/error-codes) for details.
## 2. Get task result
### Request
`POST https://api.omocaptcha.com/v2/getTaskResult`
```json theme={null}
{
"clientKey": "OMO_API_KEY",
"taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}
```
### Response
**Success:**
```json theme={null}
{
"errorId": 0,
"status": "ready",
"solution": {
"pointA": { "x": 50, "y": 30 },
"pointB": { "x": 100, "y": 70 }
}
}
```
The server returns `errorId = 0` and `status = ready`. Read the result from `solution`:
* `pointA` — coordinates of the first object (x, y), relative to the `widthView`/`heightView` you sent.
* `pointB` — coordinates of the second object.
Click both points on the image to complete the captcha.
**Processing:**
```json theme={null}
{
"errorId": 0,
"status": "processing",
"errorCode": "",
"errorDescription": ""
}
```
The server returns `status = processing`. Wait \~2 seconds and call `getTaskResult` again.
**Failure:**
```json theme={null}
{
"errorId": 1,
"errorCode": "ERROR_JOB_STATUS",
"errorDescription": "Job failed",
"status": "fail",
"solution": {}
}
```
The server returns `errorId = 1` and `status = fail`.