Quantum as a Service (QaaS) allows you to access and program on diverse Quantum Processing Units (QPUs). ## Quickstart To perform the following steps, you must first ensure that: - You have a Scaleway account and are logged in to the [Scaleway console](https://console.scaleway.com/organization) - You have created an [API key](https://www.scaleway.com/en/docs/iam/how-to/create-api-keys/) and the API key has sufficient [IAM permissions](https://www.scaleway.com/en/docs/iam/reference-content/permission-sets/) to perform the actions described on this page - You have [installed `curl`](https://curl.se/download.html) Scaleway QaaS is primarily designed to be used from dedicated quantum computing SDKs. For more information, see the [Quantum Computing - Quickstart](https://www.scaleway.com/en/docs/quantum-computing/quickstart/) documentation. 1. Configure your environment variables. This is an optional step that aims to simplify your usage of the APIs. ```bash export ACCESS_KEY="" export SECRET_KEY="" ``` 2. List the available Quantum-as-a-Service platforms. A platform is a formal definition of an allocatable hardware, QPU or GPU with a pre-installed emulator. You can select the one from the list that best fits your use case. ```bash curl -X GET \ -H "X-Auth-Token: $SCW_SECRET_KEY" \ -H "Content-Type: application/json" \ "https://api.scaleway.com/qaas/v1alpha1/platforms" ``` You should get a response like the following: Take note of the UUID of your platform of choice, it will be used in the next step. ```json { "total_count": 17, "platforms": [ { "id": "282e9874-1761-499d-b0dc-004d0e334837", "version": "0.2", "name": "QPU-BELENOS-12PQ", "provider_name": "quandela", "type": "qpu", "technology": "photonic", "max_qubit_count": 12, }, { "id": "5e52c364-03fd-4bf7-93e2-e1597e28fb83", "version": "0.1", "name": "QPU-EMERALD-54PQ", "provider_name": "iqm", "type": " qpu", "technology": "supraconductor", "max_qubit_count": 54, }, { "id": "2pai198s-918b-6bf8-13en-y15wqe7epb88", "version": "0.17", "name": "EMU-AER-8L40S", "provider_name": "aer", "type": " simulator", "technology": "general-purpose", "max_qubit_count": 36, } [...] ] } ``` 3. Run the following command to create a QPU session. A session is a time window where a user can execute quantum jobs on a specific platform. ```bash curl -X POST \ -H "X-Auth-Token: $SCW_SECRET_KEY" \ -H "Content-Type: application/json" \ -d '{ "project_id": "3j336ee9-dff0-4732-8c5a-bc4f2031ddd3", "platform_id": "2pai198s-918b-6bf8-13en-y15wqe7epb88" }'\ "https://api.scaleway.com/qaas/v1alpha1/sessions" ``` Edit the request payload according to the following information: | Parameter | Description | | :--------------- | :----------------------------------------------------------------- | | `project_id` | **REQUIRED** The ID of the Project you want to create your Database Instance in. To find your Project ID you can **[list the projects](/api/account#path-projects-list-all-projects-of-an-organization)** or consult the **[Scaleway console](https://console.scaleway.com/project/settings)**. | | `platform_id` | ID of your selected platform. | If the operation was successful, you will see a response like the following: ```json { "id": "6a134dca-5743-4ba6-9999-b84c295d591c", "name": "Justina", "platform_id": "5e52c364-03fd-4bf7-93e2-e1597e28fb83", "started_at": { "seconds": "-62135596800", "nanos": 0 }, "updated_at": { "seconds": "1700063831", "nanos": 389384664 }, "terminated_at": { "seconds": "-62135596800", "nanos": 0 }, "max_idle_duration": { "seconds": "600", "nanos": 0 }, "max_duration": { "seconds": "1800", "nanos": 0 }, "waiting_job_count": "0", "finished_job_count": "0", "status": "starting", "project_id": "3j336ee9-dff0-4732-8c5a-bc4f2031ddd3", "tags": { "value": [] }, "deduplication_id": "", "created_at": { "seconds": "1700063831", "nanos": 389384664 } } ``` Take note of the UUID of your session, it will be used in the next step. 4. Create a job to execute your quantum circuit. ```bash curl -X POST \ -H "X-Auth-Token: $SCW_SECRET_KEY" \ -H "Content-Type: application/json" \ -d '{ "circuit": { "perceval_circuit": ":PCVL:zip:eJyzCnAO87FydM4sSi7NLLFydfTM9K9wdI7MSg52DsyO9AkNCtWu9DANqMj3cg50hAPP9GwvBM+xEKgWwXPxRFELAAdTHXM=" }, "name": "my_job", "session_id": "3j336ee9-dff0-4732-8c5a-bc4f2031ddd3" }'\ "https://api.scaleway.com/qaas/v1alpha1/jobs" ``` Edit the request payload according to the following information: | Parameter | Description | | :--------------- | :----------------------------------------------------------------- | | `perceval_circuit` | Your [Perceval](https://perceval.quandela.net/docs/providers.html) circuit. | | `name` | The name of your job. | | `session_id` | The UUID of the session created in the previous step. | If the operation was successful, you will see a response like the following: ```json { "id": "f0febf59-14b8-4759-b342-09ab061691a3", "name": "Loremipsumconsequatdo", "tags": { "value": [] }, "session_id": "f49a7157-93e9-4125-bd3c-b864bb93f6bc", "created_at": { "seconds": "1700064966", "nanos": 251006133 }, "updated_at": { "seconds": "1700064966", "nanos": 251006133 }, "started_at": { "seconds": "-62135596800", "nanos": 0 }, "status": "waiting", "progress_message": { "value": "" }, "job_duration": { "seconds": "0", "nanos": 0 }, "result_distribution": { "value": "" } } ``` 5. Terminate your session once the job is complete. Make sure you specify the `session_ID` in the endpoint. This is an optional step, as all sessions have by default a set timeout of 30 minutes. ```bash curl -X POST \ -H "X-Auth-Token: $SCW_SECRET_KEY" \ -H "Content-Type: application/json" \ "https://api.scaleway.com/qaas/v1alpha1/sessions/$SESSION_ID/terminate" ``` If the operation was successful, you will see a response like the following: ```json { "id": "6a134dca-5743-4ba6-9999-b84c295d591c", "name": "Justina", "platform_id": "5e52c364-03fd-4bf7-93e2-e1597e28fb83", "started_at": { "seconds": "1700064968", "nanos": 219871003 }, "updated_at": { "seconds": "1700064975", "nanos": 489339876 }, "terminated_at": { "seconds": "1700064975", "nanos": 489339876 }, "max_idle_duration": { "seconds": "600", "nanos": 0 }, "max_duration": { "seconds": "1800", "nanos": 0 }, "waiting_job_count": "0", "finished_job_count": "0", "status": "stopping", "project_id": "3j336ee9-dff0-4732-8c5a-bc4f2031ddd3", "tags": { "value": [] }, "deduplication_id": "", "created_at": { "seconds": "1700063831", "nanos": 389384664 } } ``` ## Technical information ### Regions Scaleway Quantum as a Service is currently available globally. Refer to our [product availability documentation page](https://www.scaleway.com/en/docs/account/reference-content/products-availability) for more information. ### 0% SLA Scaleway strives to provide the best possible experience on Quantum as a Service. However, as this is an experimental service, we cannot offer a contractual Service Level Agreement (0% SLA). For details on the guarantees of [Labs offers](https://labs.scaleway.com/en/), review the special conditions for BETA services. ### Client Scaleway Quantum as a Service is available from many different SDKs to design and run quantum circuits: [Perceval](https://perceval.quandela.net/), [Qiskit](https://github.com/scaleway/qiskit-scaleway), [Cirq](https://github.com/scaleway/cirq-scaleway), [Pulser](https://github.com/scaleway/pulser-scaleway) and [PennyLane](https://github.com/scaleway/pennylane-scaleway).

Quantum as a Service API

Quickstart

Quantum as a Service API

Quickstart