Authentifizierung bei der API
Bevor Sie API-Aufrufe an den Dienst Red Hat AI Inference senden können, müssen Sie Ihre Anfragen authentifizieren. Sie können sich entweder mit einem Bearer-Token oder einem API-Schlüssel für IBM Cloud authentifizieren.
Vorbereitende Schritte
-
Erstellen Sie ein Pay-As-You-Go- oder Abonnement- IBM Cloud-Konto. Testkonten werden nicht unterstützt. Weitere Informationen oder Anleitungen zum Upgrade Ihres Kontos finden Sie unter Kontotypen.
-
Erstellen Sie ein Red Hat AI Inference-Projekt.
-
Stellen Sie sicher, dass Sie über die Rolle Writer oder höher im Dienst Red Hat AI Inference verfügen. Weitere Informationen finden Sie unter Verwalten des IAM-Zugriffs.
Authentifizierung mithilfe eines Bearer-Tokens
Bearer-Token gewährleisten einen sicheren Zugriff auf die Inferenzfunktionen Ihres Projekts und werden anhand Ihres API-Schlüssels für IBM Cloud generiert. Bearer-Token verfallen nach einer festgelegten Zeitspanne und müssen daher regelmäßig aktualisiert werden.
Das folgende Beispiel zeigt, wie man ein Bearer-Token abruft.
curl -X POST "https://iam.cloud.ibm.com/identity/token" --header "Content-Type: application/x-www-form-urlencoded" --header "Accept: application/json" --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey" --data-urlencode "apikey=$<IBM_CLOUD_API_KEY>"
Das Bearer-Token ist das in access_token der Antwort. Diese Tokens haben ein Ablaufdatum und müssen regelmäßig erneuert werden.
{"access_token":"xxxxx","refresh_token":"not_supported","token_type":"Bearer","expires_in":3600,"expiration":1770058324,"scope":"ibm openid"}
Authentifizierung mithilfe eines API-Schlüssels
Sie können sich mit einem API-Schlüssel authentifizieren, indem Sie entweder einen Service-ID-API-Schlüssel oder einen Benutzer-API-Schlüssel verwenden.
Die Verwendung einer Service-ID ist die empfohlene Methode zur Verwaltung und Delegierung von Zugriffsberechtigungen. Nachdem Sie eine Service-ID erstellt haben, erstellen Sie einen Service-ID-API-Schlüssel, um Ihre Anfragen zu authentifizieren. Weitere Informationen zum Erstellen einer Service-ID und eines API-Schlüssels in Ihrem Projekt finden Sie unter Erste Schritte mit Red Hat AI Inference.
Wenn Sie die Service-ID in IAM erstellen, weisen Sie die Zugriffsrolle Writer zu, um Chat-Vervollständigungen zu erstellen. Weisen Sie die Zugriffsrolle Reader zu, wenn Sie lediglich Modellinformationen anzeigen oder Chat-Vervollständigungen lesen möchten. Für den API-Zugriff sind keine Plattformzugriffsrollen erforderlich.
Alternativ können Sie sich mithilfe eines persönlichen Benutzer-API-Schlüssels authentifizieren. Weitere Informationen finden Sie unter Benutzer-API-Schlüssel verwalten.