SaaS로 개발하세요.
호스팅형 QXel 서비스와 Python SDK입니다. 단일 API 키로 Amazon Braket 회로를 관리형 GPU 워커에 제출하며, 직접 운영할 인프라가 없습니다.
시작하기
설치
QXel SaaS Python SDK는 Amazon Braket 회로를 관리형 GPU 워커에서 동작하는 호스팅 QXel 시뮬레이터로 제출하므로 직접 운영해야 할 인프라가 없습니다. qxel-saas로 배포되며 QXelSaas로 임포트합니다.
인증
모든 요청은 테넌트 API 키로 인증합니다. 대시보드에서 키를 발급한 뒤 SDK에 노출하세요.
퀵스타트
몇 줄의 코드로 첫 회로를 QXel SaaS에 제출해 보세요. 회로는 Amazon Braket SDK로 작성합니다.
시뮬레이터 종류
클라이언트를 생성할 때 simulator_type 인자로 시뮬레이터를 선택합니다.
작업 실행
블로킹 실행
run()은 회로를 제출하고 완료될 때까지 기다린 뒤 결과를 반환합니다. 회로를 실행하는 가장 간단한 방법입니다.
비동기 제출
submit()은 회로를 보내고 블로킹 없이 즉시 작업 핸들을 반환합니다. 작업이 느릴 때(콜드 GPU 워커는 몇 분이 걸릴 수 있습니다), 여러 회로를 한 번에 제출하고 싶을 때, 또는 작업이 실행되는 동안 다른 일을 하고 싶을 때 사용하세요.
결과 타입
Braket 결과 타입을 연결하면 측정 카운트 이상의 정보를 QXel에 요청할 수 있습니다. 결과는 measurement_counts와 함께 result_types 아래로 반환됩니다.
작업 관리
작업 상태
모든 작업에는 언제든 조회할 수 있는 핸들(QXelJob)이 있습니다. sim.get_job(job_id)로 id를 통해 조회한 뒤 상태와 헬퍼 필드를 읽으세요.
작업 목록 조회
sim.list_jobs()는 테넌트의 최근 작업들을 최신순으로, 각각 QXelJob 핸들로 반환합니다. 대시보드를 만들거나, 잊어버린 job_id를 찾거나, 실패한 작업을 필터링하는 데 사용하세요.
작업 취소
더 이상 필요 없는 작업을 중지하려면 job.cancel()을 호출하세요. 워커를 해제하고 해당 작업에 대한 과금을 중단합니다. cancel()은 갱신된 핸들을 반환합니다.