Vai al contenuto principale

Configurazione per utilizzare IBM Quantum Platform con la REST API

Puoi accedere ai processori quantistici tramite le REST API, permettendoti di lavorare con le QPU usando qualsiasi linguaggio di programmazione o framework.

1. Ottieni l'accesso​

  1. Se non hai già un account utente, creane uno dalla pagina di accesso a IBM Quantum.
  2. Crea una chiave API (chiamata anche token) nella dashboard. Tieni presente che la stessa chiave API può essere utilizzata per entrambe le regioni.
  3. Genera un bearer token IBM Cloud Identity and Access Management (IAM). Si tratta di un token a breve durata utilizzato per autenticare le richieste alla REST API. Per generarne uno, chiama la IAM Identity Services API come mostrato nella seguente richiesta di esempio:
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'

Risposta attesa

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

2. Scegli un metodo di autenticazione​

Scegli il metodo di autenticazione appropriato in base al tuo ambiente di lavoro:

Crea una variabile d'ambiente (ambiente affidabile)​

  1. Per impostare la variabile d'ambiente IQP_API_TOKEN nel tuo sistema, puoi aggiungere la riga seguente al profilo della tua shell (ad esempio .bashrc o .zshrc) oppure impostarla direttamente nel terminale:

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

    Quando richiami la variabile d'ambiente nel tuo codice, includi import os, come in questo esempio:

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

    Tieni presente che, quando crei una variabile d'ambiente, la tua chiave API viene comunque salvata localmente in testo normale e deve essere protetta adeguatamente.

  2. Autentica le richieste alla REST API di Qiskit Runtime includendo il CRN e il bearer token negli header della richiesta.

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. Facoltativo: configura il firewall​

Se necessario, usa queste informazioni per abilitare l'accesso agli endpoint API di IBM Quantum.

Passi successivi​

Raccomandazioni