api-key-Header statt Authorization: Bearer und
einen erforderlichen Query-Parameter api-version bei jedem Request.
Konfigurieren
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: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 einzigeAZURE_BASE_URLsowohl Chat- als auch Ressourcen-Aufrufe abdeckt. AZURE_API_VERSIONmü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_KEYpasst 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 SieAZURE_API_VERSIONauf eine Version, die das aufgerufene Feature unterstützt. Neuere Features der Responses API erfordern aktuelle Preview-Versionen.