Aller au contenu principal

Configurer l'utilisation d'IBM Quantum Platform avec l'API REST

Tu peux accéder aux processeurs quantiques via des API REST, ce qui te permet de travailler avec des QPU dans n'importe quel langage de programmation ou framework.

1. Obtenir l'accès​

  1. Si tu n'as pas encore de compte utilisateur, crées-en un sur la page de connexion IBM Quantum.
  2. Crée une clé API (aussi appelée token) depuis le tableau de bord. Note que la même clé API peut être utilisée pour l'une ou l'autre des régions.
  3. Génère un token bearer IBM Cloud Identity and Access Management (IAM). Il s'agit d'un token de courte durée utilisé pour authentifier les requêtes vers l'API REST. Pour en générer un, appelle l'API IAM Identity Services comme illustré dans l'exemple de requête suivant :
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'

Réponse attendue

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

2. Choisir une méthode d'authentification​

Choisis la méthode d'authentification appropriée en fonction de ton environnement de travail :

Créer une variable d'environnement (environnement de confiance)​

  1. Pour définir la variable d'environnement IQP_API_TOKEN sur ton système, tu peux ajouter la ligne suivante à ton profil shell (par exemple, .bashrc ou .zshrc) ou la définir directement dans ton terminal :

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

    Lorsque tu invoqueras la variable d'environnement dans ton code, inclus import os, comme dans cet exemple :

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

    Note que lors de la création d'une variable d'environnement, ta clé API est toujours stockée localement en texte clair et doit être protégée.

  2. Authentifie les requêtes vers l'API REST Qiskit Runtime en incluant le CRN et le token bearer dans les en-têtes de la requête.

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. Optionnel : Configurer ton pare-feu​

Si nécessaire, utilise ces informations pour activer l'accès aux points de terminaison de l'API IBM Quantum.

Prochaines étapes​

Recommandations