api-key 请求头而不是 Authorization: Bearer,并且每个请求都必须带有 api-version 查询参数。
配置
config.yaml 中配置:
运行 GoModel
验证
GET /v1/models 返回该 Azure 资源暴露的部署,并带有 owned_by: "azure"。流式传输、Responses、嵌入(Embeddings)和批处理的使用方式完全相同;批处理结果通过 /openai/batches 资源路径路由。
多个部署
每个 Azure 部署都是一个独立的端点。请使用带后缀的环境变量将它们注册为不同的提供商:azure-gpt5 和 azure-embed。如果要通过单个提供商暴露同一资源下的所有部署,请将 AZURE_BASE_URL 指向资源根路径(不带 /deployments/...),并使用虚拟模型或 AZURE_MODELS 声明具体的部署名称。
说明
- GoModel 接受门户中提供的部署级 URL。对于账户级操作(模型列表、批处理),GoModel 会自动去掉
/openai/deployments/<deployment>后缀,因此一个AZURE_BASE_URL即可同时覆盖聊天调用和资源级调用。 - 只有当您需要其他稳定版或预览版(例如较新的 Responses API 接口)时,才需要显式设置
AZURE_API_VERSION。
故障排查
401 Unauthorized/403:AZURE_API_KEY与托管该部署的资源不匹配,或 URL 中的部署名称有误。Resource not found/DeploymentNotFound:请求体中的模型必须是部署名称,而不是底层的基础模型。unsupported api version:将AZURE_API_VERSION升级到您所调用功能支持的版本。较新的 Responses API 功能需要较新的预览版本。