Azure AI Vision Image Analysis — Python SDK Quick Reference
Condensed from azure-ai-vision-imageanalysis-py. Full patterns (dense captions, smart crops, people detection) in the azure-ai-vision-imageanalysis-py plugin skill if installed.
Install
pip install azure-ai-vision-imageanalysisQuick Start
from azure.ai.vision.imageanalysis import ImageAnalysisClient
from azure.ai.vision.imageanalysis.models import VisualFeatures
client = ImageAnalysisClient(endpoint=endpoint, credential=credential)Non-Obvious Patterns
analyze_from_url(image_url=..., visual_features=[...])for URL;analyze(image_data=bytes)for file- VisualFeatures enum:
CAPTION,DENSE_CAPTIONS,TAGS,OBJECTS,READ,PEOPLE,SMART_CROPS - Async:
from azure.ai.vision.imageanalysis.aio import ImageAnalysisClient
Best Practices
- Select only needed visual features to optimize latency and cost
- Use async client for high-throughput scenarios
- Handle HttpResponseError for invalid images or auth issues
- Enable
gender_neutral_captionfor inclusive descriptions - Specify
languagefor localized captions - Use
smart_crops_aspect_ratiosmatching your thumbnail requirements - Cache results when analyzing the same image multiple times