Lompat ke konten
Intura
enid

Mulai

Kunci unduhan

Untuk apa kunci unduhan, di mana membuatnya, cara memberikannya ke SDK, dan kapan Anda sama sekali tidak membutuhkannya.

Fungsi kunci unduhan

Kunci unduhan memungkinkan SDK mengambil model milik Anda tanpa perlu masuk. Kunci hanya dipakai untuk tiga hal, dan semuanya terjadi sebelum prediksi:

  • melihat apa yang dimiliki akun Anda (client.library.list())
  • melihat model yang boleh Anda unduh (client.models.list())
  • menandatangani tautan unduhan untuk satu model (client.models.load, download, dan links)

Kunci hanya menandatangani tautan. Berkasnya datang langsung dari Cloud Storage, lewat tautan yang berlaku 15 menit, dan kunci tidak pernah dikirim ke sana. Jika tautan kedaluwarsa di tengah unduhan, tautan ditandatangani ulang satu kali.

Prediksi tidak pernah memakai kunci. Model yang sudah dimuat tidak menyimpan koneksi maupun kunci.

Membuat kunci

  1. Masuk lalu buka halaman akun Anda.
  2. Di bagian Kunci unduhan, beri nama kunci sesuai tempat kunci itu dipakai (misalnya prod-server) lalu buat.
  3. Salin saat itu juga. Ini satu-satunya saat kunci ditampilkan.

Anda bisa membuat beberapa kunci, satu per server, job CI, atau perangkat, dan mencabut kunci mana pun di halaman yang sama. Apa pun yang memakai kunci yang dicabut langsung berhenti bisa mengunduh.

Memberikan kunci ke SDK

Atur di environment:

bash
export INTURA_API_KEY=sk_...

atau berikan ke klien:

python
from intura_ai import Intura

client = Intura()                  # reads INTURA_API_KEY
client = Intura(api_key="sk_...")  # or pass it explicitly

Command line membaca variabel yang sama, atau menerima --api-key:

bash
intura-ai library --api-key sk_...

Kapan Anda tidak butuh kunci

Intura() bisa dibuat tanpa kunci. Begitu juga memuat model yang sudah diunduh:

  • client.models.load(slug) memuat versi terbaru di cache tanpa panggilan jaringan dan tanpa kunci.
  • LocalModel.load(path) menjalankan folder yang sudah Anda unduh sebelumnya, dan tidak pernah menghubungi API.

Panggilan pertama yang benar-benar butuh API memunculkan MissingAPIKey, dan pesannya menjelaskan di mana mendapatkan kunci:

python
from intura_ai import Intura, MissingAPIKey

try:
    model = Intura().models.load("chat-commerce-intent-id")
except MissingAPIKey as exc:
    print(exc)

MissingAPIKey juga merupakan ValueError.

Memeriksa apakah kunci berfungsi

client.library.list() adalah cara paling sederhana. Ia memunculkan AuthenticationError untuk kunci yang salah atau sudah dicabut, dan mengembalikan library Anda jika kunci valid.

python
from intura_ai import AuthenticationError, Intura

try:
    Intura().library.list()
except AuthenticationError:
    print("That key is wrong or revoked. Create a new one on your account page.")

Jaga kerahasiaannya

Perlakukan kunci unduhan seperti kata sandi. Simpan di variabel environment atau secret store, bukan di kode sumber. Klien tidak pernah mencetaknya: repr(client) hanya menampilkan root API. Jika kunci bocor, cabut di halaman akun Anda lalu buat yang baru.