Required. The instances that are the input to the prediction call. A DeployedModel may have an upper limit on the number of instances it supports per request, and when it is exceeded the prediction call errors in case of AutoML Models, or, in case of customer created Models, the behaviour is as documented by that Model. The schema of any single instance may be specified via Endpoint's DeployedModels' Model'sPredictSchemata'sinstanceSchemaUri.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[],[],null,["# Method: endpoints.predict\n\n**Full name**: projects.locations.endpoints.predict\n\nPerform an online prediction. \n\n### Endpoint\n\npost `https:``/``/{service-endpoint}``/v1``/{endpoint}:predict` \nWhere `{service-endpoint}` is one of the [supported service endpoints](/vertex-ai/docs/reference/rest#rest_endpoints).\n\n### Path parameters\n\n`endpoint` `string` \nRequired. The name of the Endpoint requested to serve the prediction. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`\n\n### Request body\n\nThe request body contains data with the following structure:\nFields `instances[]` `value (`[Value](https://protobuf.dev/reference/protobuf/google.protobuf/#value)` format)` \nRequired. The instances that are the input to the prediction call. A DeployedModel may have an upper limit on the number of instances it supports per request, and when it is exceeded the prediction call errors in case of AutoML Models, or, in case of customer created Models, the behaviour is as documented by that Model. The schema of any single instance may be specified via Endpoint's DeployedModels' [Model's](/vertex-ai/docs/reference/rest/v1/projects.locations.endpoints#DeployedModel.FIELDS.model) [PredictSchemata's](/vertex-ai/docs/reference/rest/v1/projects.locations.models#Model.FIELDS.predict_schemata) [instanceSchemaUri](/vertex-ai/docs/reference/rest/v1/PredictSchemata#FIELDS.instance_schema_uri).\n`parameters` `value (`[Value](https://protobuf.dev/reference/protobuf/google.protobuf/#value)` format)` \nThe parameters that govern the prediction. The schema of the parameters may be specified via Endpoint's DeployedModels' [Model's](/vertex-ai/docs/reference/rest/v1/projects.locations.endpoints#DeployedModel.FIELDS.model) [PredictSchemata's](/vertex-ai/docs/reference/rest/v1/projects.locations.models#Model.FIELDS.predict_schemata) [parametersSchemaUri](/vertex-ai/docs/reference/rest/v1/PredictSchemata#FIELDS.parameters_schema_uri). \n\n### Response body\n\nIf successful, the response body contains an instance of [PredictResponse](/vertex-ai/docs/reference/rest/v1/PredictResponse)."]]