Configurează utilizarea IBM Quantum Platform cu REST API

Poți accesa procesoarele cuantice prin REST API, ceea ce îți permite să lucrezi cu QPU-uri folosind orice limbaj de programare sau framework.

1. Obține acces

1. Dacă nu ai deja un cont de utilizator, creează unul pe pagina de autentificare IBM Quantum.
2. Creează o cheie API (numită și token) pe panou de control. Reține că aceeași cheie API poate fi folosită pentru oricare dintre regiuni.
3. Generează un token bearer IBM Cloud Identity and Access Management (IAM). Acesta este un token de scurtă durată folosit pentru autentificarea cererilor către REST API. Pentru a-l genera, apelează IAM Identity Services API așa cum este arătat în exemplul de cerere de mai jos:

Curl

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ăspuns așteptat

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

Python

# Use 'service' to invoke operations.
import requests
import json

url = 'https://iam.cloud.ibm.com/identity/token'
api_key = 'MY_APIKEY'
headers = {
 'Content-Type': 'application/x-www-form-urlendcoded',
}
data = f'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey={api_key}'
response = requests.post(url, headers=headers, data=data)

# Bearer token to authorize requests to the REST API
bearer_token = response.json()['access_token']

2. Alege o metodă de autentificare

Alege metoda de autentificare potrivită, în funcție de mediul tău de lucru:

• Creează o variabilă de mediu pentru cheia ta API (medii Python de încredere)
• Folosește cheia API direct (mediu neîncrezător)

Creează o variabilă de mediu (mediu de încredere)

1. Pentru a seta variabila de mediu IQP_API_TOKEN în sistemul tău, poți adăuga următoarea linie în profilul tău de shell (de exemplu, .bashrc sau .zshrc) sau o poți seta direct în 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

   Când apelezi variabila de mediu în codul tău, include import os, ca în acest exemplu:

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

   Reține că atunci când creezi o variabilă de mediu, cheia ta API este în continuare stocată local în text simplu și trebuie protejată corespunzător.

2. Autentifică cererile către Qiskit Runtime REST API includând CRN-ul și tokenul bearer în antetele cererii.

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. Opțional: Configurează firewall-ul

Dacă este necesar, folosește aceste informații pentru a activa accesul la endpoint-urile IBM Quantum API.

Pași următori

Recomandări

• Prezentare generală a planurilor disponibile.
• Configurează Qiskit SDK local.
• Urmează pașii din Hello world pentru a scrie și rula un program cuantic.
• Încearcă un tutorial.