Sediakan untuk menggunakan IBM Quantum Platform dengan REST API

Anda boleh mengakses pemproses kuantum dengan REST API, membolehkan anda bekerja dengan QPU menggunakan mana-mana bahasa pengaturcaraan atau rangka kerja.

1. Dapatkan akses

1. Jika anda belum mempunyai akaun pengguna, dapatkan satu di halaman log masuk IBM Quantum.
2. Cipta kunci API (juga dipanggil token) di papan pemuka. Perlu diambil perhatian bahawa kunci API yang sama boleh digunakan untuk mana-mana rantau.
3. Jana token pembawa (bearer token) IBM Cloud Identity and Access Management (IAM). Ini ialah token jangka pendek yang digunakan untuk mengesahkan permintaan ke REST API. Untuk menjana satu, panggil API Perkhidmatan Identiti IAM seperti yang ditunjukkan dalam permintaan contoh berikut:

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'

Respons yang Dijangka

{
   "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. Pilih kaedah pengesahan

Pilih kaedah pengesahan yang sesuai, bergantung pada persekitaran kerja anda:

• Cipta pemboleh ubah persekitaran untuk kunci API anda (persekitaran Python yang dipercayai)
• Guna kunci API anda secara langsung (persekitaran yang tidak dipercayai)

Cipta pemboleh ubah persekitaran (persekitaran yang dipercayai)

1. Untuk menetapkan pemboleh ubah persekitaran IQP_API_TOKEN dalam sistem anda, anda boleh menambah baris berikut ke profil shell anda (contohnya, .bashrc atau .zshrc) atau dengan menetapkannya terus dalam terminal anda:

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

   Apabila anda memanggil pemboleh ubah persekitaran dalam kod anda, sertakan import os, seperti dalam contoh ini:

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

   Perlu diambil perhatian bahawa apabila mencipta pemboleh ubah persekitaran, kunci API anda masih disimpan secara tempatan dalam teks biasa, dan perlu dilindungi.

2. Sahkan permintaan ke Qiskit Runtime REST API dengan menyertakan CRN dan token pembawa dalam pengepala permintaan.

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. Pilihan: Konfigurasi tembok api anda

Jika perlu, gunakan maklumat ini untuk membolehkan akses ke titik akhir API IBM Quantum.

Langkah seterusnya

Cadangan

• Gambaran keseluruhan pelan yang tersedia.
• Konfigurasi Qiskit SDK secara tempatan.
• Ikuti langkah dalam Hello world untuk menulis dan menjalankan atur cara kuantum.
• Cuba tutorial.