Skip to main content

Extract Image Labels

Extracts labels and tags from images using Google Vision API's label detection feature.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Vision Client Id - The unique identifier of the Vision API connection, typically obtained from the Connect node.
  • Image Path - The file path to the image from which to extract labels.

Options​

No additional options available for this node.

Output​

  • Text - An array of labels detected in the image, or "No labels found" if no labels are detected.

How It Works​

The Extract Image Labels node analyzes an image and returns descriptive labels that represent the content of the image. When executed, the node:

  1. Retrieves the Vision API client using the provided client ID
  2. Validates that the image path is not empty
  3. Opens and reads the image file from the specified path
  4. Creates a Vision API image object from the file
  5. Calls the DetectLabels method to identify labels in the image
  6. Processes the results and returns the detected labels

Requirements​

  • A valid connection to Vision API established with the Connect node
  • Valid Google Cloud credentials with appropriate permissions
  • An image file accessible from the specified path
  • Enabled Vision API in your Google Cloud project

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Vision Client ID
  • Empty image path
  • Invalid image file path
  • File read errors
  • Invalid image format
  • Network connectivity issues
  • Vision API service errors
  • Authentication failures

Usage Notes​

  • The Vision Client ID must be obtained from a successful Connect node execution
  • The image file must be accessible from the specified path
  • Supported image formats include JPEG, PNG, GIF, BMP, and TIFF
  • The node returns up to 10 labels for each image
  • Labels are returned as an array of strings describing the image content
  • If no labels are found, the output will be "No labels found"
  • Labels can be used for image categorization, tagging, or search indexing