Select objects

  1. Create a project
  2. Add a task pool
  3. Upload tasks
  4. Set up quality control
  5. Start the pool and get the results

Run the project in the Sandbox first. This helps you avoid making mistakes and spending money on a task that isn't working right.

Yandex.Toloka provides an editor for selecting an image area. It lets the performer select a polygon or rectangle area.

Let's say you have many photos with animals and you need to select dogs and identify their breed. To do this, create a task: the performer is shown a photo and has to select the dog and specify its breed.

Example of a prepared task

To run tasks and get responses:

Create a project

The project defines what the task will look like for a performer.

  1. Click the + Create project button and choose the Object segmentation in an image template.

  2. Enter a clear name and a short description for the project. Performers will see this in the task list.

  3. Write short and clear instructions (see recommendations) in the visual editor or using HTML markup. To make it clear, add pictures.
  4. Note. This tutorial shows how to create a task interface in Yandex.Toloka. You can also try creating a task interface in the Template Builder.

    The image area selection editor is automatically included in the template. This means that the performer will see the image and can select an area with the editor tools.

    Define which objects you are going to pass to the performers and receive from them in response. To do this, add input and output fields in the Specifications block.
    What are input and output data?

    Input data is types of objects that are passed to the performer for completing the task. For example, this could be a text, an image, or geographic coordinates.

    Output data is types of objects that you receive after the task is completed. For example, this could be one of several response options, typed text, or an uploaded file.

    Learn more about input and output data fields.

    The template includes the fields:

    • The image input data field for a link to an image.

      Change the data type to string to upload audio files stored on Yandex.Disk.

    • The result output data field with the "json" type for the JSON object with the point coordinates.

    Add the output data field — the required breed string to write the dog breed specified by the performer.

  5. Create the task interface in the HTML block. It describes how the task elements should be arranged in the task.

    You can use standard HTML tags and special expressions in double curly brackets for input and output data fields.

    {{field type="image-annotation" name="result" src=(proxy image)}}
    {{field type="input" name="breed" placeholder="Укажите породу собаки" width="100%"}}
    This notation describes the following task design:
    • A picture with the area selection tool.
    • Text input field.

    Leave the CSS and JavaScript blocks unchanged.

  6. Click the Preview button to see the performer's view of the task.
    Note. The project preview shows one task with standard data. You can define the number of tasks to show on the page later.
  7. Save the project.

Add a task pool

A pool is a set of paid tasks sent out for completion at the same time.

  1. Open the project and click Add pool.
  2. Give the pool any convenient name and description. The pool info is only available to you. Performers can view only the project name and description.
  3. Set the price per task page (for instance, $0.02).
    What is a task page?

    A page can contain one or several tasks. If the tasks are simple, you can add 10-20 tasks per page. Don't make pages too long because it slows down loading speed for performers.

    Performers get paid for completing the whole page.

    The number of tasks on the page is set when uploading tasks.

    What is the fair price for a task page?

    The general rule of pricing is the more time the performer spends to complete the task, the higher the price is.

    You can register in Yandex.Toloka as a performer and find out how much other requesters pay for tasks, or see examples of cost for different types of tasks.

  4. Set the Time allowed for completing a task page. It should be long enough to read the guidelines and wait for task data to download (for example, 1200 seconds).
  5. Set the Overlap, which is the number of performers to complete the same task. For image area selection tasks, it is usually 1.
  6. Turn on the Non-automatic acceptance option and enter the number of days for checking the task in the Deadline field (for example, 7).
    What is non-automatic acceptance?

    The non-automatic acceptance option allows you to review completed tasks before accepting them and paying for them. If the performer didn't follow instructions, you can reject the task. The maximum allowed period for the review is set in the Deadline field.

  7. Add Filters to choose performers.
  8. Save the pool.

Upload tasks

Prepare your own task file. Check out the example in a demo TSV file. You can find it on the pool page. At the top-left of the page, there are links to TSV files with regular, control, and training tasks.

  1. Click Upload. In the window that opens, you can also download a sample TSV file by clicking Sample file for uploading tasks.
    What is TSV?
    A TSV file presents a table as a text file in which columns are separated by tabs.

    You can work with it both in a table editor and a text editor, and then save it to the desired format. More about working with a TSV file. There is a CSV format that is similar to TSV, but you should use a TSV file for uploading.

  2. Add input data in it. The header of the input data column contains the word INPUT. Leave the other columns empty.
  3. Upload the tasks: choose Set manually and set the number of tasks (for example, 4 tasks per page).

Set up quality control

Quality control rules allow you to filter out inattentive performers. You can configure quality control both in the project and in the pool.


Quality control settings are applied to all project pools, so you can't change them in just one of the pools.

    Go to pool editing (the Edit button in the upper-right corner of the page) and click Add Quality Control Rule.

    You can copy quality control settings from another pool. To do this, click Copy settings from in the Users filter section.

  1. Add a restriction for Fast responses.

    The Minimum time per page value depends on the number of tasks on this page. It takes 2-4 seconds to identify the cat's mood. This means that a page with 10 tasks may take 20-30 seconds to complete.

    A performer can make an accidental mistake once in a while, but after 2-3 repeated mistakes you can ban the performer for a while.

    Specify the following values:

    This means that a user who completes two task pages in less than 20 seconds will be blocked for 10 days and won't be able to complete your tasks.

  2. Add the Review results quality control rule and enter the following values:

    This means that if 35% or more of a performer's responses are rejected, the performer is banned and can't access your tasks for 15 days. The rule takes effect after 3 responses of the performer are reviewed.

Start the pool and get the results

  1. Start the pool by clicking .
  2. Track the completion of tasks in the Pool statistics section.
  3. When the first results are received, you can start the review . After the specified time period, all responses are automatically accepted, regardless of their quality.
    To review assignments, go to the pool and click Review assignments.
    Note. The point coordinates are saved in JSON.