Sign in

v1

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

Analyze - Cld-Fashion

Analyze an image using the Cld-Fashion content-aware detection model. Cloudinary's fashion model is specifically dedicated to items of clothing. The response includes attributes of the clothing identified, for example whether the garment contains pockets, its material and the fastenings used.

post/analyze/cld_fashion

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": {
      "model_version": 1
    }
  },
  "limits": {
    "items": [
      {
        "type": "ai_vision",
        "used_by_request": 123,
        "remaining": 500,
        "limit": 10000,
        "reset_time": "2024-01-20T12:34:56Z"
      }
    ]
  },
  "request_id": "17c3b70c5096df0e77e838323abb7029"
}