Method: endpoints.predict

Full name: projects.locations.endpoints.predict

Perform an online prediction.

Endpoint

posthttps://{service-endpoint}/v1/{endpoint}:predict

Where{service-endpoint} is one of thesupported service endpoints.

Path parameters

endpointstring

Required. The name of the Endpoint requested to serve the prediction. Format:projects/{project}/locations/{location}/endpoints/{endpoint}

Request body

The request body contains data with the following structure:

Fields
instances[]value (Value format)

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.

parametersvalue (Value format)

The parameters that govern the prediction. The schema of the parameters may be specified via Endpoint's DeployedModels'Model'sPredictSchemata'sparametersSchemaUri.

labelsmap (key: string, value: string)

Optional. The user labels for Imagen billing usage only. Only Imagen supports labels. For other use cases, it will be ignored.

Response body

If successful, the response body contains an instance ofPredictResponse.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-16 UTC.