Skip to main content
Azure OpenAI 使用 OpenAI 的 API 格式,但有两处差异由 GoModel 负责处理:使用 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 功能需要较新的预览版本。

参考

最后修改于 2026年10月24日