Langkau ke kandungan utama

Simpan kelayakan log masuk anda

Jika anda bekerja dalam persekitaran Python yang dipercayai (seperti pada komputer riba atau stesen kerja peribadi), anda boleh menggunakan kaedah save_account() untuk menyimpan kelayakan anda secara tempatan, kemudian menggunakannya untuk memulakan perkhidmatan.

Nota

Sebelum anda mulakan​

  1. Pastikan anda mempunyai akaun IBM Cloud.
  2. Pastikan anda bekerja dalam persekitaran Python aktif dengan Qiskit SDK dan Qiskit Runtime dipasang.
  3. Aktifkan persekitaran maya Python dan jalankan Python dalam persekitaran maya anda.
  4. Log masuk ke IBM Quantum Platform dengan IBMid atau akaun Google.

Cari kelayakan akses anda​

  1. Pastikan akaun dan rantau yang betul dipilih dalam pemilih akaun di header.
  2. Cari kunci API anda. Dari papan pemuka, cipta kunci API anda, kemudian salinnya ke lokasi yang selamat supaya anda boleh menggunakannya untuk pengesahan. Perhatikan bahawa anda boleh menggunakan kunci API yang sama untuk menyambung ke mana-mana rantau.
  3. Pilihan: Cari instans yang ingin anda gunakan dari halaman Instans. Arahkan kursor ke atas CRN-nya, klik ikon untuk menyalinnya, kemudian simpan di lokasi yang selamat supaya anda boleh menggunakannya untuk mengenal pasti instans.

Simpan kelayakan akses anda​

Simpan kelayakan anda dengan menjalankan kod yang sesuai sekali bagi setiap akaun yang ingin anda simpan. Selepas menyimpan kelayakan anda, muatkannya dengan mengikuti langkah dalam Mulakan perkhidmatan Qiskit Runtime.

Simpan kelayakan yang mengakses instans tertentu:​

Jika anda mempunyai berbilang instans dan mahu Qiskit Runtime mengetahui instans mana yang hendak digunakan, simpan kelayakan yang menyertakan CRN instans.

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 kelayakan untuk pemilihan instans automatik:​

Jika anda tidak menyediakan CRN instans dan menghantar kelayakan ini ke Qiskit Runtime, instans yang sesuai akan dipilih untuk anda, berdasarkan pilihan yang dinyatakan.

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
)

Pilihan yang tersedia​

  • token: Kunci API IBM Cloud. Token anda adalah sulit. Jangan kongsikan token anda dalam kod awam.
  • instance: Secara pilihan, nyatakan instans yang hendak digunakan melalui CRN IBM Cloud atau nama instansnya.
  • plans_preference: Secara pilihan, tetapkan jenis pelan yang hendak diutamakan. Ini diabaikan jika instans dinyatakan. Pilihan yang tersedia ialah open, pay-as-you-go, flex, premium, dan on-prem. Instans jenis pelan tertentu dikecualikan jika nama pelan tidak dinyatakan. Contohnya, jika [open] dimasukkan, hanya instans Pelan Open yang tersedia. Ini diabaikan jika instance dinyatakan.
  • region: Secara pilihan, tetapkan rantau yang hendak digunakan. Nilai yang diterima ialah us-east dan eu-de. Ini diabaikan jika instance dinyatakan.
  • tags: Secara pilihan, nyatakan tag instans. Menerima senarai rentetan nama tag. Ini diabaikan jika instance dinyatakan.
  • name: Secara pilihan, namakan set kelayakan akaun ini.
  • set_as_default: Tetapkan nilai kepada True untuk menyimpan ini sebagai kelayakan lalai anda. Jika anda hanya menyimpan satu akaun, ia ditetapkan secara automatik sebagai lalai.
  • overwrite: Tetapkan nilai ini kepada True untuk mengemas kini kelayakan lalai anda.

Contoh​

Contoh 1​

Contoh ini menyimpan kelayakan untuk instans tertentu, yang membenarkan akses open dan premium. Kelayakan open ditetapkan sebagai lalai.

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 kelayakan untuk pemilihan instans automatik. Qiskit Runtime hanya akan melihat instans premium di rantau EU yang tersedia untuk akaun. Kelayakan ini menjadi lalai baharu.

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 kelayakan yang disimpan​

Untuk melihat semua kelayakan yang telah anda simpan, jalankan service.saved_accounts(). Perhatikan bahawa jika anda menyimpan kelayakan lalai dan tidak menamainya, ia dinamakan default-ibm-quantum-platform. Jika anda menamakan kelayakan lalai anda, anda akan melihat "is_default_account": true dalam output.

Pertimbangan​

  • Jika anda menyimpan berbilang akaun, gunakan parameter name untuk membezakannya.
  • Kelayakan disimpan ke $HOME/.qiskit/qiskit-ibm.json. Jangan edit fail ini secara manual.
  • Jika anda tidak menyimpan kelayakan anda, anda mesti menyatakannya setiap kali anda memulakan Session baharu (memulakan perkhidmatan Qiskit Runtime).
  • Jika anda menyatakan kelayakan secara manual, akaun yang tersimpan tidak akan digunakan.

Langkah seterusnya

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