月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
视觉快速开始
本教程用 Image Analysis 客户端库为一张远程图片生成标签。页面提供 C#、Python、Java、JavaScript 与 REST（cURL）样例，这里以 Python 为例。
注意：本页示例属于 Image Analysis 4.0 旧版路径，官方已标注弃用并计划 2028 年退役。学习用途可参考，新项目应先查看官方迁移指南。
前置条件
项 | 要求 | 备注 |
Azure 订阅 | 必需 | 可免费创建 |
Python | 3.x，并带 pip | 版本细节待核实 |
Computer Vision 资源 | 在 Azure 门户创建，获取密钥与终结点 | 可用免费层 F0 试用，待核实 |
设置环境变量
在运行应用的本机设置两个环境变量：
VISION_KEY：资源密钥。
VISION_ENDPOINT：资源终结点。
Windows 下使用
setx，设置后可能需要重启控制台。Linux 下使用 export，并执行 source ~/.bashrc。官方推荐在生产环境使用 Microsoft Entra ID 与托管标识，避免在应用中保存密钥。若使用密钥，应存放在 Azure Key Vault 中。
步骤（Python）
- 安装依赖：
pip install --upgrade azure-cognitiveservices-vision-computervision，并安装pillow。
- 新建
quickstart-file.py。代码从环境变量读取密钥与终结点，创建 ComputerVisionClient。
- 调用标签接口，传入页面给出的远程图片地址，并打印每个标签的名称与置信度。
- 运行：
python quickstart-file.py。
预期结果
控制台输出图片标签及其置信度，并以 End of Azure Vision quickstart 结束。示例输出中的标签与数值仅为样例，实际结果取决于图片内容与模型版本。
常见问题
问题 | 检查点 |
读取不到环境变量 | 设置后是否重启了控制台或编辑器 |
认证失败 | 密钥与终结点是否来自同一个资源 |
没有输出标签 | 图片是否满足格式与尺寸要求（待核实） |
清理资源
删除资源或资源组即可清理。页面给出了门户与 Azure CLI 的清理链接，本页未展开，待核实。
来源与核对
- 来源：快速开始页面，https://learn.microsoft.com/en-us/azure/ai-services/computer-vision/quickstarts-sdk/image-analysis-client-library；概览页面，https://learn.microsoft.com/en-us/azure/ai-services/computer-vision/overview
- 核对范围：正文已读，覆盖前置条件、环境变量、Python 步骤与输出。C#、Java、JavaScript 与 REST 样例未逐一核对。
- 包版本、图片限制与弃用日期未独立核对，已标注待核实（2026-11-05 获取）。
上一篇
文档智能概览
下一篇
视觉服务概览
Loading...