Lewati ke konten utama

Simpan kredensial login kamu

Kalau kamu bekerja di lingkungan Python yang terpercaya (misalnya laptop atau workstation pribadi), kamu bisa menggunakan metode save_account() untuk menyimpan kredensial secara lokal, lalu menggunakannya untuk menginisialisasi layanan.

Catatan

Sebelum mulai​

  1. Pastikan kamu punya akun IBM Cloud.
  2. Pastikan kamu bekerja di lingkungan Python yang aktif dengan Qiskit SDK dan Qiskit Runtime terinstal.
  3. Aktifkan virtual environment Python dan jalankan Python di dalamnya.
  4. Masuk ke IBM Quantum Platform dengan akun IBMid atau Google.

Temukan kredensial akses kamu​

  1. Pastikan akun dan region yang benar sudah dipilih di account switcher di header.
  2. Temukan API key kamu. Dari dashboard, buat API key kamu, lalu salin ke lokasi yang aman agar bisa digunakan untuk autentikasi. Perlu diketahui bahwa kamu bisa menggunakan API key yang sama untuk terhubung ke region mana pun.
  3. Opsional: Temukan instance yang ingin kamu gunakan dari halaman Instances. Arahkan kursor ke CRN-nya, klik ikon untuk menyalinnya, lalu simpan di lokasi yang aman agar bisa digunakan untuk mengidentifikasi instance tersebut.

Simpan kredensial akses kamu​

Simpan kredensial kamu dengan menjalankan kode yang sesuai sekali per akun yang ingin kamu simpan. Setelah menyimpan kredensial, muat kredensial tersebut dengan mengikuti langkah-langkah di Inisialisasi layanan Qiskit Runtime.

Simpan kredensial yang mengakses instance tertentu:​

Kalau kamu punya beberapa instance dan ingin dengan mudah memberi tahu Qiskit Runtime instance mana yang harus digunakan, simpan kredensial yang menyertakan CRN instance.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  token="<your-api-key>", # Use the 44-character API_KEY you created and saved from the IBM Quantum Platform Home dashboard
  name="<account-name>", # Optional
  instance="<IBM Cloud CRN or instance name>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

Simpan kredensial untuk pemilihan instance otomatis:​

Kalau kamu tidak menyertakan CRN instance dan meneruskan kredensial ini ke Qiskit Runtime, instance yang sesuai akan dipilihkan untukmu berdasarkan opsi yang ditentukan.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  token="<your=api-key>", # Use the 44-character API_KEY you created and saved from the IBM Quantum Platform Home dashboard
  name="<account-name>", # Optional
  instance="<instance-to-use>", # Optional
  plans_preference="<plan_types>", # Optional
  region="<region>", # Optional
  tags="<instance-tags>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

Opsi yang tersedia​

  • token: API key IBM Cloud. Token kamu bersifat rahasia. Jangan bagikan token kamu di kode publik.
  • instance: Opsional, tentukan instance yang akan digunakan melalui CRN IBM Cloud atau nama instance-nya.
  • plans_preference: Opsional, atur jenis plan yang diprioritaskan. Diabaikan jika instance sudah ditentukan. Opsi yang tersedia adalah open, pay-as-you-go, flex, premium, dan on-prem. Instance dengan jenis plan tertentu dikecualikan jika nama plan tersebut tidak ditentukan. Misalnya, jika [open] dimasukkan, hanya instance Open Plan yang tersedia. Diabaikan jika instance ditentukan.
  • region: Opsional, atur region yang akan digunakan. Nilai yang diterima adalah us-east dan eu-de. Diabaikan jika instance ditentukan.
  • tags: Opsional, tentukan tag instance. Menerima daftar string nama tag. Diabaikan jika instance ditentukan.
  • name: Opsional, beri nama untuk set kredensial akun ini.
  • set_as_default: Atur nilainya ke True untuk menyimpan ini sebagai kredensial default. Jika kamu hanya menyimpan satu akun, akun tersebut otomatis ditetapkan sebagai default.
  • overwrite: Atur nilai ini ke True untuk memperbarui kredensial default kamu.

Contoh​

Contoh 1​

Contoh ini menyimpan kredensial untuk instance tertentu, yang memungkinkan akses open dan premium. Kredensial open ditetapkan sebagai default.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(token="<API_TOKEN>", instance="<CRN_for_premium_instance>",
                                  name="premium")
QiskitRuntimeService.save_account(token="<API_TOKEN>", instance="<CRN_for_open_instance>",
                                  name="open", set_as_default=True)

Contoh 2​

Contoh ini menyimpan kredensial untuk pemilihan instance otomatis. Qiskit Runtime hanya akan melihat instance premium di region EU yang tersedia untuk akun tersebut. Kredensial ini menjadi default yang baru.

QiskitRuntimeService.save_account(
    token="your-api-key",
    set_as_default=True,
    overwrite = True,

    # Set instance "filters" instead of specifying the instance:
    region="eu-de",
    plans_preference=["premium"]
  )

Lihat kredensial yang tersimpan​

Untuk melihat semua kredensial yang sudah kamu simpan, jalankan service.saved_accounts(). Perlu diketahui bahwa jika kamu menyimpan kredensial default tanpa menamainya, kredensial tersebut akan diberi nama default-ibm-quantum-platform. Jika kamu menamakan kredensial default, kamu akan melihat "is_default_account": true di output.

Pertimbangan​

  • Jika kamu menyimpan beberapa akun, gunakan parameter name untuk membedakannya.
  • Kredensial disimpan di $HOME/.qiskit/qiskit-ibm.json. Jangan edit file ini secara manual.
  • Jika kamu tidak menyimpan kredensial, kamu harus menentukannya setiap kali memulai sesi baru (menginstansiasi layanan Qiskit Runtime).
  • Jika kamu menentukan kredensial secara manual, akun yang tersimpan tidak akan digunakan.

Langkah selanjutnya

Rekomendasi
Source: IBM Quantum docs — updated 5 Mar 2026
English version on doQumentation — updated 7 Mei 2026
This translation based on the English version of 11 Mar 2026