Skip to main content
IBM Quantum Platform
이 REST API는 환경에서 해당 기능을 사용으로 설정한 On-Prem Plan 멤버만 사용 가능합니다.

IBM Quantum System REST API

IBM® ( Quantum System REST API )는 고객 사내에 설치된 온프레미스 양자 컴퓨터에 직접 접속할 수 있게 해줍니다. 이 API는 고객사의 인프라(일반적으로 HPC 환경)와 통합된 후 로컬에 배포됩니다. 이 API의 역할은 QPU와 기존 런타임의 이종 리소스를 추상화하는 것입니다. 사용자는 이 인터페이스를 통해 하드웨어별 세부 사항을 직접 관리할 필요 없이, QPU에서 ‘ Qiskit Runtime ’ 프라이미티브를 사용하여 워크로드를 실행할 수 있습니다.

인증

모든 요청의 HTTP 헤더에 IAM( IBM Cloud® Identity and Access Management ) 베어러 토큰 을 반드시 포함해야 합니다. 베어러 토큰을 생성하려면 먼저 통합 과정의 일환으로 온보딩 시 생성한 API 키를 사용해야 합니다(API 키가 없는 경우 관리자에게 문의하십시오). 그런 다음 다음 curl 요청을 사용하여 IAM REST 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": "<NEW_BEARER_TOKEN>",
   "refresh_token": "not_supported",
   "token_type": "Bearer",
   "expires_in": 3600,
   "expiration": 1473188353,
   "scope": "ibm_openid"
}
베어러 토큰이란 무엇인가요?

보유자 토큰은 1시간 이내에 만료되는 임시 인증 정보입니다. 획득한 토큰의 유효 기간이 만료된 후에는, IBM Cloud 또는 기타 서비스 API를 계속 호출하려면 새로운 토큰을 생성해야 합니다. 모든 계정 내에서 귀하에게 할당된 접근 권한 수준에 따라 허용된 작업만 수행할 수 있습니다.

API 응답의 response expires_in 속성을 사용하여 특정 액세스 토큰의 유효 기간을 확인하십시오. 베어러 토큰에 대한 자세한 내용은 IBM Cloud 문서를 참조하십시오.

또한, REST API에 대한 모든 요청에는 요청 헤더에 인스턴스의 클라우드 리소스 이름 (CRN)이 포함되어야 합니다. 왼쪽 상단 메뉴에서 ‘인스턴스 ’ 페이지로 이동한 후 ‘직접 액세스’ 탭을 선택하면 액세스 권한이 있는 인스턴스를 확인할 수 있습니다. 각 인스턴스는 CRN 식별자와 함께 나열되며, 사용자의 인프라(일반적으로 HPC 환경)를 나타냅니다. 이 페이지에 접속할 수 없는 경우, 관리자에게 문의하십시오.

모든 요청 시, 다음 형식에 따라 bearer 토큰, CRN 및 IBM -API-Version을 및 Service-CRN Authorization 헤더에 포함하여 전송하십시오:

Authorization: Bearer <YOUR_BEARER_TOKEN>
Service-CRN: <YOUR_INSTANCE_CRN>
IBM-API-Version: <YYYY-MM-DD>

요청 예제:

curl -X 'GET' \
 '<YOUR_QSA_URL>/v1/backends' \
 -H 'accept: application/json' \
 -H 'Authorization: Bearer <YOUR_BEARER_TOKEN>' \
 -H 'Service-CRN: <YOUR_INSTANCE_CRN>' \
 -H 'IBM-API-Version: 2026-02-15'

작업을 제출하다

작업을 제출할 때 다음 사항에 유의하십시오:

  • '작업 생성' 작업을 사용하여 기본 작업을 제출하십시오.
  • 하나의 작업에 여러 회로를, 해당 회로를 나타내는 OpenQASM 문자열 배열 형태로 제출할 수 있습니다.
  • 매개변수를 program_id 사용하여 사용하려는 기본 도형을 지정하십시오. 사용 가능한 기본값은 와 sampler 입니다 estimator.
  • 온프레미스 QPU에 작업을 제출할 때는 IBM Cloud Direct Access 인스턴스의 CRN을 지정해야 합니다.
  • 백엔드 이름으로 온프레미스 퀀텀 시스템 이름을 지정해야 합니다. On-Prem Plan 에 접속할 수 있다면, IBM Quantum Platform 의 ‘Compute resources’ 섹션에서 백엔드 이름을 확인할 수 있습니다.

회로 1개와 관측 가능 변수 1개를 사용하여 Estimator 작업을 생성하는 요청 예시:

curl -X 'POST' \
'<YOUR_QSA_URL>/v1/jobs' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <YOUR_BEARER_TOKEN>' \
-H 'Service-CRN: <YOUR_DIRECT_ACCESS_PLAN_INSTANCE_CRN>' \
-H 'IBM-API-Version: 2026-02-15' \
-H 'Content-Type: application/json' \
--data-raw '{
{
"id": "6e32f594-189e-4bc5-89a2-3c21e1c7e75a",
"program_id": "sampler",
"backend": "ibm_<YOUR_SYSTEM_NAME>",
"timeout_secs": 10000,
"storage": {
 "input": {
   "type": "ibmcloud_cos",
   "region": "us-east",
   "region_type": "regional",
   "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
   "object_name": "params:6e32f594-189e-4bc5-89a2-3c21e1c7e75a"
 },
 "results": {
   "type": "ibmcloud_cos",
   "region": "us-east",
   "region_type": "regional",
   "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
   "object_name": "results:6e32f594-189e-4bc5-89a2-3c21e1c7e75a"
 },
 "logs": {
   "type": "ibmcloud_cos",
   "region": "us-east",
   "region_type": "regional",
   "bucket_crn": "crn:v1:bluemix:public:cloud-object-storage:global:a/abc123:abc123:bucket:my-bucket",
   "object_name": "logs:6e32f594-189e-4bc5-89a2-3c21e1c7e75a"
 }
}
}
}'
이 페이지가 도움이 되었습니까?
GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.