v1

latestOpenAPI 3.0.3MITraw.githubusercontent.com2025-02-09165953.5 KB
Analysis

Analyze - Google Tagging

Provides tags for an image using Google's tagging service.

post/analyze/google_tagging

Request body

asyncboolean

Whether to perform the analysis asynchronously. If true, the response is returned immediately and analysis is done in the background. Once complete, a webhook notification will be sent to the specified URL and/or to the URLs defined in the Webhook Notifications settings of your Cloudinary Console.

notification_urlstring

The webhook URL to notify when the analysis is complete. Only relevant when async is set to true.

Example request

{
  "source": {
    "asset_id": "e12345b5c456c8901bbb0efc00c0fcf",
    "uri": "https://res.cloudinary.com/demo/image/upload/sample.jpg"
  },
  "notification_url": "https://path.to/webhook"
}

Response

Analysis succeeded

request_idstring

Example response

{
  "data": {
    "analysis": {
      "label_annotations": {
        "labels": [
          {
            "label": "cat",
            "score": 0.9
          },
          {
            "label": "table",
            "score": 0.8
          }
        ]
      }
    }
  },
  "limits": {
    "items": [
      {
        "type": "ai_vision",
        "used_by_request": 123,
        "remaining": 500,
        "limit": 10000,
        "reset_time": "2024-01-20T12:34:56Z"
      }
    ]
  },
  "request_id": "17c3b70c5096df0e77e838323abb7029"
}