Google Cloud Vision - Start Annotate Files Operation



StartGcpVisionAnnotateFilesOperation is designed to trigger file annotation operations. This processor should be used in pair with the GetGcpVisionAnnotateFilesOperationStatus Processor. Outgoing FlowFiles contain the raw response to the request returned by the Vision server. The response is in JSON format and contains the result and additional metadata as written in the Google Vision API Reference documents.


The JSON Payload is a request in JSON format as documented in the Google Vision REST API reference document. Payload can be fed to the processor via the JSON Payload property or as a FlowFile content. The property has higher precedence over FlowFile content. Please make sure to delete the default value of the property if you want to use FlowFile content payload. A JSON payload template example:

    "requests": [
            "inputConfig": {
                "gcsSource": {
                    "uri": "gs://${gcs.bucket}/${filename}"
                "mimeType": "application/pdf"
            "features": [{
                    "type": "${vision-feature-type}",
                    "maxResults": 4
            "outputConfig": {
                "gcsDestination": {
                    "uri": "gs://${output-bucket}/${filename}/"
                "batchSize": 2

Features types

You can find more details at Google Vision Feature List

Example: How to setup a simple Annotate Image Flow


Create the following flow

  • Create an input and output bucket
  • Make sure the input files(s) are available in the input GCS bucket
  • Set the bucket property of ListGCSBucket processor to your input bucket name
  • Keep the default value of JSON PAYLOAD property in StartGcpVisionAnnotateFilesOperation
  • Set the Output Bucket property to your output bucket name in StartGcpVisionAnnotateFilesOperation
  • Setup GCP Credentials Provider Service for all GCP related processor
  • Execution steps: