דלג לתוכן הראשי

הגדרת שימוש ב-IBM Quantum Platform עם REST API

ניתן לגשת למעבדים קוונטיים באמצעות REST APIs, מה שמאפשר לך לעבוד עם QPUs בכל שפת תכנות או מסגרת עבודה.

1. קבלת גישה​

  1. אם עדיין אין לך חשבון משתמש, צור אחד בדף ההתחברות של IBM Quantum.
  2. צור מפתח API (הנקרא גם טוקן) בלוח הבקרה. שים לב שניתן להשתמש באותו מפתח API עבור כל אחד מהאזורים.
  3. צור טוקן bearer של IBM Cloud Identity and Access Management‏ (IAM). זהו טוקן קצר-מועד המשמש לאימות בקשות ל-REST API. כדי ליצור אותו, קרא ל-IAM Identity Services API כפי שמוצג בדוגמת הבקשה הבאה:
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'

תגובה צפויה

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

2. בחירת שיטת אימות​

בחר את שיטת האימות המתאימה, בהתאם לסביבת העבודה שלך:

יצירת משתנה סביבה (סביבה מהימנה)​

  1. כדי להגדיר את משתנה הסביבה IQP_API_TOKEN במערכת שלך, תוכל להוסיף את השורה הבאה לפרופיל ה-shell שלך (לדוגמה, .bashrc או .zshrc) או להגדיר אותו ישירות בטרמינל:

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

    כשאתה מפעיל את משתנה הסביבה בקוד שלך, כלול import os, כמו בדוגמה הזו:

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

    שים לב שבעת יצירת משתנה סביבה, מפתח ה-API שלך עדיין מאוחסן באופן מקומי כטקסט רגיל, ויש לשמור עליו בזהירות.

  2. אמת בקשות ל-Qiskit Runtime REST API על ידי הוספת ה-CRN וטוקן ה-bearer לכותרות הבקשה.

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. אופציונלי: הגדרת חומת האש שלך​

במידת הצורך, השתמש במידע זה כדי לאפשר גישה לנקודות הקצה של IBM Quantum API.

הצעדים הבאים​

המלצות