Azure AI Foundry

先分清平台、模型原厂和部署

官方现称 Microsoft Foundry，Azure AI Foundry 是仍常见的旧名称。它是 Azure 上的多厂商目录与部署平台，不是所有目录模型的原厂。Azure OpenAI、Microsoft 模型及合作伙伴模型可能使用不同条款、区域、接口和内容安全配置；本站 /v1/chat/completions 只是已配置渠道的网关协议。

请求通常使用部署名

在 Foundry 中先把目录模型部署成一个 Azure 资源，并为 deployment 自定义名称。请求的 model 通常填部署名，而不是目录显示的模型 ID；该部署同时固定模型版本、容量类型、筛选和限流配置。遇到 404 时先检查资源 endpoint、部署名和 API 版本，不要只尝试另一个模型别名。

生产优先 Microsoft Entra ID

Foundry 支持 API Key 与 Microsoft Entra ID。快速验证可用 key，但生产优先采用 Entra 的无密钥认证和 Cognitive Services User 等最小权限角色，令牌 scope 要与目标服务匹配。API Key 只能存服务端秘密管理器并定期轮换；本站令牌、Azure key 和 Entra access token 互不通用。

接口与 SDK 正在迁移

Azure OpenAI endpoint、Foundry Models endpoint、OpenAI/v1 与提供商专用路径的能力不完全相同。官方已弃用 Azure AI Inference beta SDK，并计划在 2026-08-26 退役，建议迁移到 GA 的 OpenAI/v1 与稳定 OpenAI SDK。迁移时同时核对 Base URL、部署名、API version、响应字段、工具和流事件。

计费由部署类型决定

Foundry 平台浏览本身不等于免费推理。语言、视觉或音频可按 token 或单模型计量单位收费；Provisioned Throughput、托管计算与微调模型还可能产生预置容量、训练和持续托管费用。给每个部署设置预算、Cost Management、Azure Monitor 和用量告警，并在删除实验部署前确认是否仍有托管资源。

429、错误与安全

401/403 检查 Entra scope、角色、key 与模型权限，404 检查 endpoint 和部署名。429 可能来自 TPM/RPM、PTU 已满或共享容量，应遵循 retry-after-ms，限制并发并做有界退避；持续问题再调整 quota 或部署类型。记录请求 ID、实际模型版本、区域和筛选结果，内容安全不替代应用自身授权、审计与隐私控制。