GeetestSelectObjectTask

Select object captcha is a common image verification. The user selects grid cells whose subject matches the requested anchor.

1. Create task

Request

POST https://api.omocaptcha.com/v2/createTask

Parameter	Type	Required	Description
`clientKey`	`String`	✅	Client account key
`task.type`	`String`	✅	`GeetestSelectObjectTask`
`task.imageBase64`	`String`	✅	Base64-encoded 3×3 grid image
`task.question`	`String`	✅	Captcha question (e.g. `Select 3 images with`)
`task.anchor`	`String`	✅	Base64-encoded anchor image (shown right after the question)

curl -X POST https://api.omocaptcha.com/v2/createTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "OMO_API_KEY",
    "task": {
      "type": "GeetestSelectObjectTask",
      "imageBase64": "BASE64_BODY_HERE",
      "question": "Select 3 images with",
      "anchor": "BASE64_ICON_HERE"
    }
  }'

const axios = require('axios');

const { data } = await axios.post('https://api.omocaptcha.com/v2/createTask', {
  clientKey: 'OMO_API_KEY',
  task: {
    type: 'GeetestSelectObjectTask',
    imageBase64: 'BASE64_BODY_HERE',
    question: 'Select 3 images with',
    anchor: 'BASE64_ICON_HERE'
  }
});
console.log(data);

import requests

res = requests.post('https://api.omocaptcha.com/v2/createTask', json={
    'clientKey': 'OMO_API_KEY',
    'task': {
        'type': 'GeetestSelectObjectTask',
        'imageBase64': 'BASE64_BODY_HERE',
        'question': 'Select 3 images with',
        'anchor': 'BASE64_ICON_HERE'
    }
})
print(res.json())

<?php
$ch = curl_init('https://api.omocaptcha.com/v2/createTask');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
  'clientKey' => 'OMO_API_KEY',
  'task' => [
    'type' => 'GeetestSelectObjectTask',
    'imageBase64' => 'BASE64_BODY_HERE',
    'question' => 'Select 3 images with',
    'anchor' => 'BASE64_ICON_HERE'
  ]
]));
echo curl_exec($ch);

Response Success:

{
  "errorId": 0,
  "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

The server returns errorId = 0 with a taskId on success. Failure:

{
  "errorId": 1,
  "errorCode": "",
  "errorDescription": ""
}

The server returns errorId = 1 and an errorCode.

2. Get task result

Request

POST https://api.omocaptcha.com/v2/getTaskResult

{
  "clientKey": "OMO_API_KEY",
  "taskId": "49f9f60a-c809-4af0-93c0-0409b72e67e0"
}

Response Success:

{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  "status": "ready",
  "solution": {
    "objects": [0, 1, 6]
  }
}

The server returns errorId = 0 and status = ready. Read the answer from solution.objects.

objects is the list of matching cell indices (0–8), counted left-to-right, top-to-bottom:

Row 1: 0, 1, 2
Row 2: 3, 4, 5
Row 3: 6, 7, 8

Processing:

{
  "status": "processing",
  "errorId": 0,
  "errorCode": "",
  "errorDescription": ""
}

The server returns errorId = 0 and status = processing. Wait 2 seconds and retry. Failure:

{
  "errorId": 1,
  "errorCode": "ERROR_JOB_STATUS",
  "errorDescription": "Job failed",
  "status": "fail",
  "solution": {}
}

The server returns errorId = 1.

API Reference

Guides

GeetestSelectObjectTask

1. Create task

2. Get task result

​1. Create task

​2. Get task result

1. Create task

2. Get task result