Skip to content
On this page
Home
>Task(Recognition)
>VisionEngine

Vision Engine

WARNING

Create the task with the createTask.

This interface does not need to obtain the results separately, will directly return the image recognition results!

The task type field is as follows

  • VisionEngine

Create Task

Create the task with the createTask.

Task Object Structure

Note that this type of task returns the task execution result directly after createTask, rather than getting it asynchronously through getTaskResult.

PropertiesTypeRequiredDescription
typeStringRequiredVisionEngine
moduleStringRequiredAll supported models are shown in the table below
websiteURLStringOptionalPage source url to improve accuracy
imageStringRequiredbase64 encoded content of the image (no newlines, no data:image/***;charset=utf-8;base64,)
imageBackgroundStringRequiredbase64 encoded content of the background image (no newlines, no data:image/***;charset=utf-8;base64,)
questionStringOptionalspace_detection requires

SUPPORT IMG TYPES

moduleCaptcha ExampleimageimageBackground
slider_1img.pngimg.pngimg.png
rotate_1img_2.pngimg_2.pngimg_2.png
space_detectionimg_2.pngimg_2.png

Example Request

text
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "VisionEngine",
    "websiteURL": "https://xxxx.com",
    "module": "slider_1",
    "image": "/9j/4AAQSkZJRgABA......",
    "imageBackground": "/9j/4AAQSkZJRgABA......",
    "question": "Please click on the unique object",
  }
}

Example Response

json
{
  "errorId": 0,
  "errorCode": "",
  "errorDescription": "",
  "status": "ready",
  "solution": {
     // slider
     "angle": 154,   

     // rotate
     "distance": 213,  

    // space_detection
     "box": [
        163.5,
        107.5
     ]
  },
  "taskId": "..."
}

Use SDK Request

python
# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'

import capsolver

# capsolver.api_key = "..."

img_path = os.path.join(Path(__file__).resolve().parent, "queue-it.jpg")
with open(img_path, 'rb') as f:
    solution = capsolver.solve({
        "type": "VisionEngine",
        "module": "slider_1",
        "image": "/9j/4AAQSkZJRgABA......",
        "imageBackground": "/9j/4AAQSkZJRgABA......"
    })
    print(solution)
go
package main

import (
	"fmt"
	capsolver_go "github.com/capsolver/capsolver-go"
	"log"
)

func main() {
	// first you need to install sdk
	//go get github.com/capsolver/capsolver-go
	//export CAPSOLVER_API_KEY='...' or
	//capSolver := CapSolver{ApiKey:"..."}

	capSolver := capsolver_go.CapSolver{}
	solution, err := capSolver.Solve(map[string]any{
		"type":   "VisionEngine",
		"module": "slider_1",
		"image":   "/9j/4AAQSkZJRgABA......",
        "imageBackground": "/9j/4AAQSkZJRgABA......"
	})
	if err != nil {
		log.Fatal(err)
		return
	}
	fmt.Println(solution)
}