AnnotateImageRequest

Request for performing Google Cloud Vision API tasks over a user-provided image, with user-requested features, and with context information.

JSON representation 
{
  "image": {
    object(Image)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "customLabelDetectionModels": [
    string
  ]
}
Fields
image

object(Image)

The image to be processed.

features[]

object(Feature)

Requested features.

imageContext

object(ImageContext)

Additional context that may accompany the image.

customLabelDetectionModels[]

string

When making a request with a CUSTOM_LABEL_DETECTION value in the features.type field, the CustomLabelDetectionModels field must specify the custom model(s) to use. The format of the model name mimics the resource URL of the custom model: /projects/PROJECT_ID/models/MODEL_ID, or /models/MODEL_ID if the model belongs to the current project.

Image

Client image to perform Google Cloud Vision API tasks over.

JSON representation 
{
  "content": string,
  "source": {
    object(ImageSource)
  }
}
Fields
content

string (bytes format)

Image content, represented as a stream of bytes. Note: As with all bytes fields, protobuffers use a pure binary representation, whereas JSON representations use base64.

A base64-encoded string.
source

object(ImageSource)

Google Cloud Storage image location, or publicly-accessible image URL. If both content and source are provided for an image, content takes precedence and is used to perform the image annotation request.

ImageSource

External image source (Google Cloud Storage or web URL image location).

JSON representation 
{
  "gcsImageUri": string,
  "imageUri": string
}
Fields
gcsImageUri

string

Use imageUri instead.

The Google Cloud Storage URI of the form gs://bucket_name/object_name. Object versioning is not supported. See Google Cloud Storage Request URIs for more info.
imageUri

string

The URI of the source image. Can be either:

  1. A Google Cloud Storage URI of the form gs://bucket_name/object_name. Object versioning is not supported. See Google Cloud Storage Request URIs for more info.

  2. A publicly-accessible image HTTP/HTTPS URL. When fetching images from HTTP/HTTPS URLs, Google cannot guarantee that the request will be completed. Your request may fail if the specified host denies the request (e.g. due to request throttling or DOS prevention), or if Google throttles requests to the site for abuse prevention. You should not depend on externally-hosted images for production applications.

When both gcsImageUri and imageUri are specified, imageUri takes precedence.