Saat aplikasi Anda memanggil layanan model dari lingkungan yang tidak tepercaya—seperti browser atau aplikasi seluler—gunakan layanan backend yang aman untuk menerbitkan kunci API temporary guna mencegah eksposur kunci API permanen.
Kunci API temporary mewarisi izin dari kunci API yang digunakan untuk menghasilkannya. Misalnya, kunci tersebut dapat membatasi akses ke model atau basis pengetahuan tertentu.
Prasyarat
Anda harus terlebih dahulu membuat kunci API permanen di halaman API Key Management (Singapore) atau API Key Management (US East (Virginia)) atau API Key Management (China (Beijing)) atau API Key Management (Hong Kong (China)), lalu atur sebagai variabel lingkungan DASHSCOPE_API_KEY. Untuk petunjuk konfigurasi, lihat Konfigurasikan kunci API sebagai variabel lingkungan.
Contoh permintaan
Kunci API temporary kedaluwarsa setelah 60 detik secara default. Anda dapat mengatur waktu hidup (TTL)-nya antara 1 hingga 1.800 detik.
Kunci API berbeda berdasarkan wilayah.
URL di bawah ini berlaku untuk Singapore. Jika Anda menggunakan model di wilayah Beijing, ganti URL dengan: https://dashscope.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800
curl -X POST "https://dashscope-intl.aliyuncs.com/api/v1/tokens?expire_in_seconds=1800" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" Contoh respons
Contoh respons Normal
{
"token":"st-****",
"expires_at":1744080369
}Parameter respons
Nama Parameter |
Tipe |
Deskripsi |
Contoh |
token |
String |
Kunci API temporary yang dihasilkan. |
st-**** |
expires_at |
Number |
Waktu kedaluwarsa dalam bentuk stempel waktu UNIX, dalam satuan detik. |
1744080369 |
Contoh respons error
{
"code":"InvalidApiKey",
"message":"Invalid API-key provided.",
"request_id":"902fee3b-f7f0-9a8c-96a1-6b4ea25af114"
}Parameter respons
Nama Parameter |
Tipe |
Deskripsi |
Contoh |
code |
String |
Kode kesalahan. Untuk informasi lebih lanjut mengenai penyebab dan solusi, lihat halaman Pesan error. |
InvalidApiKey: Kode error kunci API tidak valid |
message |
String |
Pesan error. |
Invalid API-key provided. |
request_id |
String |
ID permintaan. |
902fee3b-f7f0-9a8c-96a1-6b4ea25af114 |
FAQ
T: Dapatkah saya menghapus secara manual kunci API temporary yang telah dibuat?
Tidak, Anda tidak dapat melakukannya. Kunci API temporary memiliki siklus hidup tetap dan kedaluwarsa secara otomatis pada akhir siklus hidupnya.