月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
第一次调用 Azure OpenAI
用一个最小的 Python 脚本，对已部署的 Azure OpenAI 模型发起第一次请求，并看到文本输出。本页只走通调用这一段；资源创建与模型部署的完整步骤待核实。
前置条件
项目 | 状态 |
Azure 订阅，且已有 Azure OpenAI 或 Foundry 资源 | 待核实（快速入门页面本次未能抓取，见“来源与核对”） |
已在资源中部署一个模型，并记下部署名称（deployment name） | 待核实 |
资源的 v1 端点，格式为 https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/ | 已确认（官方示例格式） |
认证方式：API Key（环境变量 AZURE_OPENAI_API_KEY）或 Microsoft Entra ID | 已确认（两种方式均在官方示例中出现） |
Python 环境，安装 openai 与 azure-identity | 已确认（ pip install openai azure-identity） |
步骤
- 在资源中完成模型部署，记下部署名称。资源与部署的具体操作：待核实。
- 安装 SDK：
pip install openai azure-identity。
- 设置环境变量，例如
AZURE_OPENAI_API_KEY（使用 API Key 时）。避免把密钥写进代码或提交到仓库。
- 运行下面的示例，把占位符替换为自己的资源名与部署名：
预期结果
- 脚本输出一段文本，即模型对输入的回答。
- 若使用 Entra ID，需先完成
az login或等效登录，并确保身份具备相应数据平面角色（具体角色名称待核实）。
常见问题
现象 | 可能原因与处理 |
请求被拒绝且返回 content_filter | 提示词触发了内容过滤（官方说明：阻止时返回 HTTP 400 与 content_filter 代码） |
返回 429（Too Many Requests） | 超出配额或速率限制，参见“配额与速率限制”页面的说明，加入退避重试 |
模型不可用于所选区域 | 模型未在该区域按所选部署类型上线，参见“区域与可用性”页面 |
部署名称不正确 | model 参数应填部署名称，而非模型名称（官方示例中的写法） |
清理资源
- 若不再使用，删除不需要的部署，避免持续占用配额或产生费用。Provisioned（PTU）部署按小时计费，停用前请先删除（详见“计费与成本”页面）。
- 删除资源的具体步骤：待核实。
来源与核对
- 核对范围：仅元数据。快速入门页面（
/azure/foundry/openai/quickstart）与资源创建页面（/azure/foundry/openai/how-to/create-resource）抓取均返回 HTTP 404，未读到正文，因此资源创建、模型部署与清理步骤均未核实。上面的代码示例与端点格式取自已读正文的 Responses API 页面与函数调用页面，需在真实环境中验证后再发布。
- 获取日期：2026-11-05。
上一篇
Responses API
下一篇
区域与可用性
Loading...