Edit

Share via

Azure Vision vectorizer

Important

This vectorizer is in public preview under Supplemental Terms of Use. The 2024-05-01-Preview REST API and newer preview APIs support this feature.

The Azure Vision vectorizer connects to Azure Vision in Foundry Tools via a Microsoft Foundry resource. At query time, the vectorizer uses the multimodal embeddings API to generate embeddings.

To determine where this model is accessible, see the region availability for multimodal embeddings. Your data is processed in the Geo where your model is deployed.

Note

This vectorizer is bound to Foundry Tools. Execution of the vectorizer is charged at the Foundry Tools Standard price.

Vectorizer parameters

Parameters are case sensitive.

Parameter name Description
resourceUri The endpoint of the Foundry resource, which must have the the https://<resource-name>.services.ai.azure.com or https://<resource-name>.cognitiveservices.azure.com format. You can find this endpoint on the Keys and Endpoint page in the Azure portal.
apiKey The API key of the Foundry resource.
modelVersion (Required) The model version to be passed to the Azure Vision API for generating embeddings. It's important that all embeddings stored in a given index field are generated using the same modelVersion. For information about version support for this model refer to multimodal embeddings.
authIdentity A user-managed identity used by the search service for connecting to Foundry. You can use either a system- or user-managed identity. To use a system-managed identity, leave apiKey and authIdentity blank. The system-managed identity is used automatically. A managed identity must have Cognitive Services User permissions to use this vectorizer.

Supported vector query types

The Azure Vision vectorizer supports text, imageUrl, and imageBinary vector queries.

Expected field dimensions

A vector field configured with the Azure Vision vectorizer should have a dimensions value of 1024.

Sample definition

"vectorizers": [
    {
        "name": "my-ai-services-vision-vectorizer",
        "kind": "aiServicesVision",
        "aiServicesVisionParameters": {
            "resourceUri": "https://westus.api.cognitive.microsoft.com/",
            "apiKey": "0000000000000000000000000000000000000",
            "authIdentity": null,
            "modelVersion": "2023-04-15"
        },
    }
]

See also

  • Last updated on