Azure AI Foundry – LLM Translator: Bearer-Token Auth schlägt fehl, Subscription-Key funktioniert

Question

Ich nutze Azure AI Foundry und den Translator LLM-Endpunkt (api-version=2025-10-01-preview) mit deploymentModel. Mit Subscription-Key funktioniert der Aufruf, aber mit AAD-Bearer-Token (Audience https://cognitiveservices.azure.com/.default) erhalte ich:

{"code":"401","message":"Ocp-Apim-Subscription-Key is missing"}

Erwartetes Verhalten: Zugriff mit Bearer-Token ohne Subscription-Key, wie in der Preview-Dokumentation beschrieben.

Ich habe:

• App-Registrierung in Entra ID mit API-Berechtigung „Microsoft Cognitive Services → user_impersonation“ und Admin-Consent.
• Token wird mit Scope https://cognitiveservices.azure.com/.default angefordert.
• RBAC-Rollen gesetzt:
  • Cognitive Services User auf der Translator-Ressource.
    • Azure AI User auf dem Foundry-Projekt.
      • Contributor auf der Resource Group.

Trotzdem schlägt der Call fehl.

Answer 1

Hallo Kalle Gerarts,

Ich weiß, es ist frustrierend, keinen Bearer-Token verwenden zu können. Aber lassen Sie mich Ihnen Schritt für Schritt helfen.

Es handelt sich um einen zweistufigen Prozess.

Sie müssen zunächst mit Ihrem Abonnementschlüssel ein Zugriffstoken (Access Token) abrufen und dieses anschließend in Ihrer Übersetzungsanfrage verwenden. Um Ihr Autorisierungstoken zu erhalten:

Methode: POST

URL: https://YOUR_REGION.api.cognitive.microsoft.com/sts/v1.0/issuetoken

Beispiel:: https://eastus.api.cognitive.microsoft.com/sts/v1.0/issuetoken

Headers:

Ocp-Apim-Subscription-Key: YOUR_AZURE_SUBSCRIPTION_KEY  
Content-Length: 0

Body: Dies bitte leer lassen

Sobald Sie auf „Send“ klicken, erhalten Sie im Antworttext eine lange Token-Zeichenkette. Dies ist Ihr Bearer-Token – kopieren Sie ihn einfach für den nächsten Schritt.Aufgrund von Formatierungsproblemen in Ihrem Bearer-Token kann es jedoch zu dem Fehler 401001 kommen. Um dies zu vermeiden, verwenden Sie bitte den folgenden Python-Code, um das Zugriffstoken abzurufen:

import requests
import uuid

SPEECH_KEY = "<SUBSCRIPTION-KEY>"
SPEECH_REGION = "<REGION>"


def get_access_token():
    url = f"https://{SPEECH_REGION}.api.cognitive.microsoft.com/sts/v1.0/issuetoken"
    headers = {
        "Ocp-Apim-Subscription-Key": SPEECH_KEY
    }
    try:
        r = requests.post(url, headers=headers)
        r.raise_for_status()
        return r.text
    except Exception as e:
        print(f"Error getting token: {e}")
        return None

token = get_access_token()
print("Access Token:", token)

Then Use the Token to Translate TextVerwenden Sie anschließend das Token zur Übersetzung von Text

Methode: POSTURL: https://api.cognitive.microsofttranslator.com/translate

Abfrageparameter:

api-version: 2025-10-01-preview

Headers:

Authorization: Bearer YOUR_TOKEN_FROM_STEP_1
Content-Type: application/json
Ocp-Apim-Subscription-Region: eastus2

Body:

{
  "inputs": [
    {
      "text": "I would really like to drive your car around the block a few times.",
      "language": "en",
      "targets": [
        {
          "language": "es"
        }
      ]
    }
  ]
}

Klicken Sie auf „Send“, und Sie erhalten den übersetzten Text in der Antwort!

Aktuell ist die Authentifizierung mit einem Bearer-Token nur für den Standardübersetzungsdienst gültig. Der Zugriff auf LLM-Modelle über Azure AI Foundry erfordert derzeit die Verwendung eines Abonnementschlüssels.
Hier ist die unterstützte Dokumentation:
https://learn.microsoft.com/en-us/azure/ai-services/translator/text-translation/preview/translate-api
Bitte akzeptieren Sie dies als Antwort.
Vielen Dank, dass Sie sich an das Microsoft-Fragen-und-Antworten-Portal gewendet haben.