Skip to main content
Azure OpenAI verwendet das Format der OpenAI-API mit zwei Unterschieden, die GoModel übernimmt: einen api-key-Header statt Authorization: Bearer und einen erforderlichen Query-Parameter api-version bei jedem Request.

Konfigurieren

Oder in config.yaml:

GoModel starten

Prüfen

GET /v1/models liefert die Deployments, die die Azure-Ressource bereitstellt, mit owned_by: "azure". Streaming, Responses, Embeddings und Batches funktionieren genauso; Batch-Ergebnisse werden über den Ressourcenpfad /openai/batches geroutet.

Mehrere Deployments

Jedes Azure-Deployment ist ein eigener Endpunkt. Registrieren Sie sie über Umgebungsvariablen mit Suffix als separate Provider:
Dadurch werden azure-gpt5 und azure-embed registriert. Um alle Deployments einer Ressource über einen einzigen Provider bereitzustellen, richten Sie AZURE_BASE_URL auf die Wurzel der Ressource (ohne /deployments/...) und verwenden Sie virtuelle Modelle oder AZURE_MODELS, um bestimmte Deployment-Namen anzubieten.

Hinweise

  • GoModel akzeptiert die Deployment-bezogene URL, die Ihnen das Portal anzeigt. Für kontoweite Operationen (Auflisten von Modellen, Batches) entfernt GoModel das Suffix /openai/deployments/<deployment> automatisch, sodass eine einzige AZURE_BASE_URL sowohl Chat- als auch Ressourcen-Aufrufe abdeckt.
  • AZURE_API_VERSION müssen Sie nur dann explizit setzen, wenn Sie eine andere stabile oder Preview-Version benötigen – zum Beispiel eine neuere Version der Responses API.

Fehlerbehebung

  • 401 Unauthorized / 403 – AZURE_API_KEY passt nicht zu der Ressource, die das Deployment hostet, oder der Deployment-Name in der URL ist falsch.
  • Resource not found / DeploymentNotFound – Das Modell im Request-Body muss der Deployment-Name sein, nicht das zugrunde liegende Basismodell.
  • unsupported api version – Erhöhen Sie AZURE_API_VERSION auf eine Version, die das aufgerufene Feature unterstützt. Neuere Features der Responses API erfordern aktuelle Preview-Versionen.

Referenzen

Zuletzt geändert am 24. Oktober 2026