Action: image-metadata-generation

Generates metadata from an input image and performs similarity matching against a set of provided metadata examples to return the most relevant results.

Requirements

• Input files must be images
• objectKeys must contain only image paths
• kSimilarMetadata - must be provided and contain at least one item

Provide kSimilarMetadata in a POST request to enhance the quality of the API response, providing multiple example objects is highly recommended, as it helps the API generate more accurate and contextually relevant results. Each item in kSimilarMetadata should be a dictionary (JSON object) containing representative example data.

Example If the input image shows Times Square in New York City, your request might include metadata like:

 "KSimilarMetadata" : [
  {
    "event:location": "New Bristol, Terranova",
    "keywords:tags": "economy|markets|Noventis|GEF|Terranova|report",
    "photo type": "Landscape photography, Nature photography, Macro photography",
    "referenceL list:list" : [
      "Getty Images: Times Square, New York City",
      "Shutterstock Editorial: Times Square NYC",
      "National Geographic Photo Archive: Times Square",
      "New York Public Library Digital Collections: Times Square",
      "Lonely Planet: Times Square Photo Guide"
      ],
    "summary:text": "This report provides a comprehensive analysis of financial trends and investment opportunities across emerging markets in the Terranova region, focusing on the strategies employed by Noventis Group."
  }
]

Output

• Dictionary of generated metadata fields and values
• See Schema

Result: The response will include an imageMetadata object containing detailed information extracted from the image.

"imageMetadata": {
        "isSuccess": true,
        "result": {
          "event:location": "New York City, USA",
          "keywords:tags": "Times Square, New York City, cityscape, urban, skyscrapers, billboards, neon lights, taxis, pedestrians, metropolitan",
          "photo type": "Landscape photography, Architecture photography, Street photography",
          "referenceL list": [
            "Getty Images: Times Square, New York City",
            "Shutterstock Editorial: Times Square NYC",
            "National Geographic Photo Archive: Times Square",
            "New York Public Library Digital Collections: Times Square",
            "Lonely Planet: Times Square Photo Guide"
          ],
          "summary:text": "The image captures the vibrant and bustling atmosphere of Times Square in New York City, showcasing the iconic skyscrapers, billboards, and neon lights that make this location a global tourist destination. The scene highlights the dynamic and fast-paced nature of the city, with yellow taxis and pedestrians creating a sense of energy and activity."
        },