Microsoft Azure Image Search Client — ImageDetailSearch

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Image Search Client — ImageDetailSearch
  description: 'Microsoft Azure Image Search Client — ImageDetailSearch. 1 operations. Lead operation: Microsoft Azure The
    Image Detail Search Api Lets You Search On Bing And Get Back Insights About An Image, Such As Webpages That Include The
    Image This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request Insights
    Of Images And The Json Response Objects That Contain Th'
  tags:
  - Microsoft Azure
  - ImageDetailSearch
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: image-search-client-imagedetailsearch
    baseUri: https://api.cognitive.microsoft.com/bing/v7.0
    description: Microsoft Azure Image Search Client — ImageDetailSearch business capability. Self-contained, no shared references.
    resources:
    - name: images-details
      path: /images/details
      operations:
      - name: microsoftazureimagesdetails
        method: GET
        description: Microsoft Azure The Image Detail Search Api Lets You Search On Bing And Get Back Insights About An Image,
          Such As Webpages That Include The Image This Section Provides Technical Details About The Query Parameters And Headers
          That You Use To
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Accept
          in: header
          type: string
          description: The default media type is application/json. To specify that the response use [JSON-LD](http://json-ld.org/),
            set the Accept header to application/ld+json.
        - name: Accept-Language
          in: header
          type: string
          description: A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing
            order of preference. For additional information, in
        - name: Content-Type
          in: header
          type: string
          description: Optional request header. If you set the [modules](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#modulesrequested)
            que
        - name: User-Agent
          in: header
          type: string
          description: 'The user agent originating the request. Bing uses the user agent to provide mobile users with an optimized
            experience. Although optional, you are encouraged to '
        - name: X-MSEdge-ClientID
          in: header
          type: string
          description: 'Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often
            flights new features and improvements, and it uses the client '
        - name: X-MSEdge-ClientIP
          in: header
          type: string
          description: The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location.
            Bing uses the location information to determine safe sear
        - name: X-Search-Location
          in: header
          type: string
          description: A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing
            uses the location information to determine safe search beha
        - name: cab
          in: query
          type: number
          description: The bottom coordinate of the region to crop. The coordinate is a fractional value of the original image's
            height and is measured from the top, left corner of th
        - name: cal
          in: query
          type: number
          description: 'The left coordinate of the region to crop. The coordinate is a fractional value of the original image''s
            height and is measured from the top, left corner of the '
        - name: car
          in: query
          type: number
          description: The right coordinate of the region to crop. The coordinate is a fractional value of the original image's
            height and is measured from the top, left corner of the
        - name: cat
          in: query
          type: number
          description: The top coordinate of the region to crop. The coordinate is a fractional value of the original image's
            height and is measured from the top, left corner of the i
        - name: ct
          in: query
          type: string
          description: The crop type to use when cropping the image based on the coordinates specified in the cal, cat, car,
            and cab parameters. The following are the possible values.
        - name: cc
          in: query
          type: string
          description: A 2-character country code of the country where the results come from. For a list of possible values,
            see [Market Codes](https://docs.microsoft.com/en-us/rest/a
        - name: id
          in: query
          type: string
          description: An ID that uniquely identifies an image. Use this parameter to ensure that the specified image is the
            first image in the list of images that Bing returns. The [
        - name: imgUrl
          in: query
          type: string
          description: The URL of an image that you want to get insights of. Use this parameter as an alternative to using
            the insightsToken parameter to specify the image. You may al
        - name: insightsToken
          in: query
          type: string
          description: 'An image token. The [Image](https://docs.microsoft.com/en-us/rest/api/cognitiveservices/bing-images-api-v7-reference#image)
            object''s [imageInsightsToken](https:'
        - name: modules
          in: query
          type: array
          description: 'A comma-delimited list of insights to request. The following are the possible case-insensitive values.
            All: Return all insights, if available, except Recognized'
        - name: mkt
          in: query
          type: string
          description: The market where the results come from. Typically, mkt is the country where the user is making the
            request from. However, it could be a different country if the
        - name: q
          in: query
          type: string
          description: The user's search query term. The term cannot be empty. The term may contain [Bing Advanced Operators](http://msdn.microsoft.com/library/ff795620.aspx).
            For exa
          required: true
        - name: safeSearch
          in: query
          type: string
          description: 'Filter images for adult content. The following are the possible filter values. Off: May return images
            with adult content. If the request is through the Image Se'
        - name: setLang
          in: query
          type: string
          description: The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language
            code. For example, the language code for English is E
  exposes:
  - type: rest
    namespace: image-search-client-imagedetailsearch-rest
    port: 8080
    description: REST adapter for Microsoft Azure Image Search Client — ImageDetailSearch. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/images/details
      name: images-details
      description: REST surface for images-details.
      operations:
      - method: GET
        name: microsoftazureimagesdetails
        description: Microsoft Azure The Image Detail Search Api Lets You Search On Bing And Get Back Insights About An Image,
          Such As Webpages That Include The Image This Section Provides Technical Details About The Query Parameters And Headers
          That You Use To
        call: image-search-client-imagedetailsearch.microsoftazureimagesdetails
        with:
          Accept: rest.Accept
          Accept-Language: rest.Accept-Language
          Content-Type: rest.Content-Type
          User-Agent: rest.User-Agent
          X-MSEdge-ClientID: rest.X-MSEdge-ClientID
          X-MSEdge-ClientIP: rest.X-MSEdge-ClientIP
          X-Search-Location: rest.X-Search-Location
          cab: rest.cab
          cal: rest.cal
          car: rest.car
          cat: rest.cat
          ct: rest.ct
          cc: rest.cc
          id: rest.id
          imgUrl: rest.imgUrl
          insightsToken: rest.insightsToken
          modules: rest.modules
          mkt: rest.mkt
          q: rest.q
          safeSearch: rest.safeSearch
          setLang: rest.setLang
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: image-search-client-imagedetailsearch-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Image Search Client — ImageDetailSearch. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-image-detail-search
      description: Microsoft Azure The Image Detail Search Api Lets You Search On Bing And Get Back Insights About An Image,
        Such As Webpages That Include The Image This Section Provides Technical Details About The Query Parameters And Headers
        That You Use To
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: image-search-client-imagedetailsearch.microsoftazureimagesdetails
      with:
        Accept: tools.Accept
        Accept-Language: tools.Accept-Language
        Content-Type: tools.Content-Type
        User-Agent: tools.User-Agent
        X-MSEdge-ClientID: tools.X-MSEdge-ClientID
        X-MSEdge-ClientIP: tools.X-MSEdge-ClientIP
        X-Search-Location: tools.X-Search-Location
        cab: tools.cab
        cal: tools.cal
        car: tools.car
        cat: tools.cat
        ct: tools.ct
        cc: tools.cc
        id: tools.id
        imgUrl: tools.imgUrl
        insightsToken: tools.insightsToken
        modules: tools.modules
        mkt: tools.mkt
        q: tools.q
        safeSearch: tools.safeSearch
        setLang: tools.setLang
      outputParameters:
      - type: object
        mapping: $.