Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex AI Studio
  • Getting started with Model Gallery
    • About Yandex AI Studio
    • Yandex Workflows
    • Quotas and limits
    • Terms and definitions
  • Switching from the AI Assistant API to Responses API
  • Compatibility with OpenAI
    • Overview
    • API authentication
        • Overview
          • Overview
          • Describe
          • List
          • Cancel
          • Delete
  • Access management
  • Pricing policy
  • Audit Trails events
  • Public materials
  • Release notes

In this article:

  • gRPC request
  • ListBatchInferencesRequest
  • ListBatchInferencesResponse
  • BatchInferenceTask
  • BatchCompletionRequest
  • CompletionOptions
  • ReasoningOptions
  • JsonSchema
  • ErrorsInfo
  • LineError
  • BatchError
  1. API references
  2. Batch Inference API
  3. gRPC
  4. BatchInference
  5. List

Batch Inference Service API, gRPC: BatchInferenceService.List

Written by
Yandex Cloud
Updated at August 8, 2025
  • gRPC request
  • ListBatchInferencesRequest
  • ListBatchInferencesResponse
  • BatchInferenceTask
  • BatchCompletionRequest
  • CompletionOptions
  • ReasoningOptions
  • JsonSchema
  • ErrorsInfo
  • LineError
  • BatchError

Lists tasks in folder

gRPC requestgRPC request

rpc List (ListBatchInferencesRequest) returns (ListBatchInferencesResponse)

ListBatchInferencesRequestListBatchInferencesRequest

{
  "folder_id": "string",
  "page_size": "int64",
  "page_token": "string",
  "status": "Status"
}

Field

Description

folder_id

string

Required field. Folder ID for which the list of tasks will be provided.

page_size

int64

page_token

string

status

enum Status

Batch inference status for filtering

  • STATUS_UNSPECIFIED
  • CREATED
  • PENDING
  • IN_PROGRESS
  • COMPLETED
  • FAILED
  • CANCELED

ListBatchInferencesResponseListBatchInferencesResponse

{
  "tasks": [
    {
      "task_id": "string",
      "operation_id": "string",
      "folder_id": "string",
      "model_uri": "string",
      "source_dataset_id": "string",
      // Includes only one of the fields `completion_request`
      "completion_request": {
        "model_uri": "string",
        "source_dataset_id": "string",
        "completion_options": {
          "temperature": "google.protobuf.DoubleValue",
          "max_tokens": "google.protobuf.Int64Value",
          "reasoning_options": {
            "mode": "ReasoningMode"
          }
        },
        "data_logging_enabled": "bool",
        // Includes only one of the fields `json_object`, `json_schema`
        "json_object": "bool",
        "json_schema": {
          "schema": "google.protobuf.Struct"
        }
        // end of the list of possible fields
      },
      // end of the list of possible fields
      "status": "Status",
      "result_dataset_id": "string",
      "labels": "map<string, string>",
      "created_by": "string",
      "created_at": "google.protobuf.Timestamp",
      "started_at": "google.protobuf.Timestamp",
      "finished_at": "google.protobuf.Timestamp",
      "errors": {
        "status": "google.rpc.Status",
        "line_errors": [
          {
            "line_number": "int64",
            "message": "string"
          }
        ],
        "batch_errors": [
          {
            "batch_number": "int64",
            "first_line": "int64",
            "last_line": "int64",
            "message": "string"
          }
        ]
      }
    }
  ],
  "next_page_token": "string"
}

Field

Description

tasks[]

BatchInferenceTask

next_page_token

string

BatchInferenceTaskBatchInferenceTask

Field

Description

task_id

string

operation_id

string

folder_id

string

model_uri

string

source_dataset_id

string

completion_request

BatchCompletionRequest

Includes only one of the fields completion_request.

status

enum Status

  • STATUS_UNSPECIFIED
  • CREATED
  • PENDING
  • IN_PROGRESS
  • COMPLETED
  • FAILED
  • CANCELED

result_dataset_id

string

labels

object (map<string, string>)

created_by

string

created_at

google.protobuf.Timestamp

started_at

google.protobuf.Timestamp

finished_at

google.protobuf.Timestamp

errors

ErrorsInfo

BatchCompletionRequestBatchCompletionRequest

Field

Description

model_uri

string

Required field.

source_dataset_id

string

Required field.

completion_options

CompletionOptions

data_logging_enabled

bool

json_object

bool

Includes only one of the fields json_object, json_schema.

Unsupported

json_schema

JsonSchema

Includes only one of the fields json_object, json_schema.

Unsupported

CompletionOptionsCompletionOptions

Field

Description

temperature

google.protobuf.DoubleValue

max_tokens

google.protobuf.Int64Value

reasoning_options

ReasoningOptions

ReasoningOptionsReasoningOptions

Field

Description

mode

enum ReasoningMode

  • REASONING_MODE_UNSPECIFIED
  • DISABLED
  • ENABLED_HIDDEN

JsonSchemaJsonSchema

Field

Description

schema

google.protobuf.Struct

ErrorsInfoErrorsInfo

Field

Description

status

google.rpc.Status

The error result of the operation in case of failure or cancellation.

line_errors[]

LineError

Errors by lines

batch_errors[]

BatchError

Errors by batches

LineErrorLineError

Field

Description

line_number

int64

message

string

BatchErrorBatchError

Field

Description

batch_number

int64

first_line

int64

Range of lines in batch

last_line

int64

message

string

Was the article helpful?

Previous
Describe
Next
Cancel
© 2025 Direct Cursus Technology L.L.C.