Zum Hauptinhalt springen

Einrichtung zur Verwendung von IBM Quantum Platform mit REST-API

Du kannst auf Quantenprozessoren mit REST-APIs zugreifen, sodass du mit QPUs in jeder Programmiersprache oder jedem Framework arbeiten kannst.

1. Zugang erhalten​

  1. Falls du noch kein Benutzerkonto hast, erstelle eines auf der IBM Quantum-Anmeldeseite.
  2. Erstelle einen API-Schlüssel (auch Token genannt) auf dem Dashboard. Beachte, dass derselbe API-Schlüssel für beide Regionen verwendet werden kann.
  3. Generiere ein IBM Cloud Identity and Access Management (IAM) Bearer-Token. Dies ist ein kurzlebiges Token, das zur Authentifizierung von Anfragen an die REST-API verwendet wird. Um eines zu generieren, rufe die IAM Identity Services API auf, wie in der folgenden Beispielanfrage gezeigt:
curl -X POST 'https://iam.cloud.ibm.com/identity/token' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=MY_APIKEY'

Erwartete Antwort

{
   "access_token": "eyJhbGciOiJIUz......sgrKIi8hdFs",
   "refresh_token": "SPrXw5tBE3......KBQ+luWQVY=",
   "token_type": "Bearer",
   "expires_in": 3600,
   "expiration": 1473188353
}

2. Wähle eine Authentifizierungsmethode​

Wähle die geeignete Authentifizierungsmethode, abhängig von deiner Arbeitsumgebung:

Erstelle eine Umgebungsvariable (vertrauenswürdige Umgebung)​

  1. Um die IQP_API_TOKEN-Umgebungsvariable in deinem System festzulegen, kannst du die folgende Zeile zu deinem Shell-Profil hinzufügen (z.B. .bashrc oder .zshrc) oder sie direkt in deinem Terminal setzen:

    export IQP_API_TOKEN=<your-API_KEY> # Use the 44-character API_KEY you created and saved from the IBM Quantum Platform Home dashboard

    Wenn du die Umgebungsvariable in deinem Code aufrufst, füge import os hinzu, wie in diesem Beispiel:

    import os
    api_token = os.environ['IQP_API_TOKEN']

    Beachte, dass beim Erstellen einer Umgebungsvariablen dein API-Schlüssel immer noch lokal im Klartext gespeichert ist und geschützt werden sollte.

  2. Authentifiziere Anfragen an die Qiskit Runtime REST-API, indem du den CRN und das Bearer-Token in die Request-Header aufnimmst.

curl -X 'GET' \
   'https://quantum.cloud.ibm.com/api/v1/usage' \
   '-H accept: application/json' \
   '-H authorization: Bearer <BEARER_TOKEN>' \
   '-H Service-CRN: <INSTANCE_CRN>'

3. Optional: Konfiguriere deine Firewall​

Falls erforderlich, verwende diese Informationen, um den Zugriff auf die IBM Quantum-API-Endpunkte zu ermöglichen.

Nächste Schritte​

Empfehlungen