Atur Kunci API sebagai variabel lingkungan di Alibaba Cloud Model Studio - Alibaba Cloud Model Studio

Kami merekomendasikan Anda mengatur Kunci API sebagai variabel lingkungan untuk menghindari penentuan eksplisit saat menggunakan Alibaba Cloud Model Studio SDK dan mengurangi risiko kebocoran API. Topik ini menjelaskan cara mengonfigurasi Kunci API sebagai variabel lingkungan.

Prasyarat

Anda telah mengaktifkan Model Studio dan memperoleh Kunci API.

Prosedur

Linux

Variabel lingkungan permanen

Untuk mengonfigurasi Kunci API sebagai variabel lingkungan permanen yang digunakan dalam sesi baru, atur sebagai variabel lingkungan permanen.

Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.bashrc:
```
# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bashrc
```
Anda juga dapat mengedit file ~/.bashrc secara manual.
Edit Secara Manual
Jalankan perintah berikut untuk membuka file ~/.bashrc.
```
nano ~/.bashrc
```
Tambahkan konten berikut ke dalam file:
```
# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
```
Di editor nano, tekan Ctrl+X lalu Y. Tekan Enter untuk menyimpan dan menutup file.
Jalankan perintah berikut untuk membuat perubahan berlaku:
```
source ~/.bashrc
```
Buat sesi baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
```
echo $DASHSCOPE_API_KEY
```

Variabel lingkungan sementara

Untuk menggunakan Kunci API sebagai variabel lingkungan sementara hanya untuk sesi saat ini, atur sebagai variabel lingkungan sementara.

Jalankan perintah berikut:

# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
```
echo $DASHSCOPE_API_KEY
```

macOS

Variabel lingkungan permanen

Untuk mengonfigurasi Kunci API sebagai variabel lingkungan permanen yang digunakan dalam sesi baru, atur sebagai variabel lingkungan permanen.

Jalankan perintah berikut untuk memeriksa tipe Shell default:
```
echo $SHELL
```
Lakukan operasi berikut berdasarkan tipe Shell Anda:
Zsh
1. Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.zshrc:
```
# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc
```
  Anda juga dapat mengedit file ~/.zshrc secara manual.
  Edit Secara Manual
  Jalankan perintah berikut untuk membuka file konfigurasi:
  nano ~/.zshrc
  Tambahkan konten berikut ke dalam file:
  # Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda. export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  Di editor nano, tekan Ctrl+X lalu Y. Tekan Enter untuk menyimpan dan menutup file.
2. Jalankan perintah berikut untuk membuat perubahan berlaku:
```
source ~/.zshrc
```
3. Buat sesi baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
```
echo $DASHSCOPE_API_KEY
```
Bash
1. Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.bash_profile:
```
# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile
```
  Anda juga dapat mengedit file ~/.bash_profile secara manual.
  Edit Secara Manual
  Jalankan perintah berikut untuk membuka file:
  nano ~/.bash_profile
  Tambahkan konten berikut ke dalam file:
  # Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda. export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  Di editor nano, tekan Ctrl+X lalu Y. Tekan Enter untuk menyimpan dan menutup file.
2. Jalankan perintah berikut untuk membuat perubahan berlaku:
```
source ~/.bash_profile
```
3. Buat sesi baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
```
echo $DASHSCOPE_API_KEY
```

Variabel lingkungan sementara

Untuk menggunakan Kunci API sebagai variabel lingkungan sementara hanya untuk sesi saat ini, atur sebagai variabel lingkungan sementara.

Perintah berikut hanya bekerja untuk Zsh dan Bash.

Jalankan perintah berikut:

# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
```
echo $DASHSCOPE_API_KEY
```

Windows

Di Windows, Anda dapat mengatur variabel lingkungan melalui Properti Sistem, Baris Perintah, atau PowerShell.

Properti Sistem

Catatan

Variabel lingkungan yang dikonfigurasi dengan cara ini efektif secara permanen.
Modifikasi variabel lingkungan sistem memerlukan izin administratif.
Setelah mengonfigurasi variabel lingkungan, itu tidak akan segera memengaruhi jendela perintah, IDE, atau aplikasi lain yang sudah terbuka. Anda perlu me-restart program-program tersebut atau membuka jendela baris perintah baru agar variabel lingkungan berlaku.

Tekan Win+Q di desktop Anda. Masukkan "Edit the system environment variables" di kotak pencarian, dan klik untuk membuka jendela System Properties.
Di jendela System Properties, klik Environment Variables. Di bagian System Variables, klik New, masukkan DASHSCOPE_API_KEY sebagai nama variabel, dan Kunci API aktual Anda sebagai nilai variabel.
Klik OK di ketiga kotak dialog.
Buka CMD atau Windows PowerShell dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
- CMD:
```
echo %DASHSCOPE_API_KEY%
```
- Windows PowerShell:
```
echo $env:DASHSCOPE_API_KEY
```

CMD

Variabel lingkungan permanen

Untuk mengonfigurasi Kunci API sebagai variabel lingkungan permanen yang digunakan dalam sesi baru, atur sebagai variabel lingkungan permanen.

Jalankan perintah berikut:

# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"

Buat sesi baru.
Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
```
echo %DASHSCOPE_API_KEY%
```

Variabel lingkungan sementara

Untuk menggunakan Kunci API sebagai variabel lingkungan sementara hanya untuk sesi saat ini, atur sebagai variabel lingkungan sementara.

Jalankan perintah berikut:

# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
set DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

Jalankan perintah berikut di sesi saat ini untuk memeriksa apakah variabel lingkungan berlaku:
```
echo %DASHSCOPE_API_KEY%
```

PowerShell

Variabel lingkungan permanen

Untuk mengonfigurasi Kunci API sebagai variabel lingkungan permanen yang digunakan dalam sesi baru, atur sebagai variabel lingkungan permanen.

Jalankan perintah berikut:

# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
[Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)

Buat sesi baru.
Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan berlaku:
```
echo $env:DASHSCOPE_API_KEY
```

Variabel lingkungan sementara

Untuk menggunakan Kunci API sebagai variabel lingkungan sementara hanya untuk sesi saat ini, atur sebagai variabel lingkungan sementara.

Jalankan perintah berikut:

# Ganti YOUR_DASHSCOPE_API_KEY dengan Kunci API Anda.
$env:DASHSCOPE_API_KEY = "YOUR_DASHSCOPE_API_KEY"

Jalankan perintah berikut di sesi saat ini untuk memeriksa apakah variabel lingkungan berlaku:
```
echo $env:DASHSCOPE_API_KEY
```

FAQ

T: Saya telah menjalankan perintah echo untuk memastikan variabel lingkungan. Namun, saat saya menjalankan kode saya, masih muncul pesan bahwa Kunci API tidak ditemukan atau Kunci API tidak valid?

A: Penyebabnya mungkin:

Skenario 1: Variabel lingkungan yang Anda atur tidak permanen. Variabel lingkungan sementara hanya berlaku untuk sesi terminal saat ini dan tidak akan berlaku di IDE atau aplikasi lain yang sudah dibuka. Silakan lihat metode dalam topik ini untuk mengatur variabel lingkungan permanen.
Skenario 2: Anda belum me-restart IDE, alat baris perintah, atau aplikasi Anda.
- Biasanya Anda perlu me-restart IDE (seperti VS Code) atau alat baris perintah untuk memuat variabel lingkungan terbaru.
- Jika variabel lingkungan diatur setelah Anda menerapkan aplikasi, Anda mungkin perlu me-restart layanan aplikasi agar memuat ulang variabel lingkungan.
Skenario 3: Anda perlu menambahkan variabel lingkungan ke file konfigurasi. Jika aplikasi Anda dimulai melalui manajer layanan (seperti systemd atau supervisord), Anda mungkin perlu menambahkan variabel lingkungan ke file konfigurasi manajer layanan.
Skenario 4: Anda menggunakan perintah sudo. Jika Anda menjalankan skrip menggunakan sudo python xx.py, Anda mungkin kehilangan variabel lingkungan pengguna saat ini karena sudo tidak mewarisi semua variabel lingkungan secara default. Anda dapat menggunakan perintah sudo -E python xx.py, di mana opsi -E memastikan bahwa variabel lingkungan dilewatkan. Jika Anda memiliki izin untuk menjalankan skrip, Anda dapat menjalankannya langsung menggunakan python xx.py.
Skenario 5: Anda mungkin perlu mengonfigurasi URL dasar dari Model Studio. Gunakan salah satu metode berikut:
- Tambahkan URL dasar ke kode Anda:
```
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
```
- Atur URL dasar sebagai variabel lingkungan:
```
DASHSCOPE_HTTP_BASE_URL='https://dashscope-intl.aliyuncs.com/api/v1'
```