Referensi

Konfigurasi

Argumen dan variabel lingkungan klien: kunci unduhan, folder cache, root API, timeout, retry, klien httpx Anda sendiri, dan logging.

Pengaturan dan asalnya

Pengaturan	Argumen	Environment
Kunci unduhan	`Intura(api_key=...)`	`INTURA_API_KEY`
Folder cache	`load(..., cache_dir=...)`	`INTURA_CACHE_DIR`, lalu `XDG_CACHE_HOME`
Root API	`Intura(base_url=...)`	`INTURA_BASE_URL` (default `https://ai.intura.co/api`)

Argumen mengalahkan environment. Jika folder cache tidak diatur, model disimpan di ~/.cache/intura.

Argumen klien

python

Intura(
    api_key=None,          # your download key; falls back to INTURA_API_KEY
    *,
    base_url=None,         # falls back to INTURA_BASE_URL, then https://ai.intura.co/api
    timeout=None,          # seconds to wait for one API response; 30 by default
    max_retries=2,         # retries for connection errors, timeouts, 429 and 5xx
    default_headers=None,  # sent on every API request
    http_client=None,      # your own httpx.Client
)

AsyncIntura menerima argumen yang sama, dengan httpx.AsyncClient untuk http_client.

api_key hanya dibutuhkan oleh panggilan yang menghubungi API, jadi memuat model dari cache berjalan tanpanya. Lihat Kunci unduhan.
timeout berlaku untuk setiap panggilan API. Jika tidak diatur sementara Anda memakai http_client sendiri, timeout klien itu yang dipakai, bukan ditimpa.
max_retries menghitung percobaan ulang untuk panggilan yang tidak pernah dijawab layanan, dibatasi lajunya, atau gagal. Permintaan yang ditolak karena isinya tidak pernah dicoba ulang. Lihat Error.
default_headers untuk proxy atau header tracing, bukan untuk autentikasi.

Memakai klien httpx sendiri

Untuk proxy atau transport khusus, pakai klien httpx Anda sendiri. Paket ini mengatur URL dan header di setiap permintaan, dan tidak pernah menutup klien yang tidak ia buka:

python

import httpx
from intura_ai import Intura

client = Intura(http_client=httpx.Client(proxy="http://proxy:3128"))

Menutup klien

Klien membuka connection pool untuk panggilan API-nya. Pakai sebagai context manager, atau panggil close() (await aclose() di AsyncIntura) setelah selesai:

python

with Intura() as client:
    model = client.models.load("chat-commerce-intent-id")

model.predict("ongkirnya berapa?")   # the model doesn't need the client

Logging

Paket ini mencatat log lewat modul logging standar, dengan logger intura_ai, dan diam sampai aplikasi Anda memasang handler. Untuk skrip atau notebook, set_verbose() mencetak barisnya ke stderr, termasuk satu baris saat model mulai diunduh:

python

import intura_ai

intura_ai.set_verbose()          # INFO and above
intura_ai.set_verbose(False)     # back to warnings only

Versi yang terpasang

python

import intura_ai

intura_ai.__version__

atau intura-ai --version di shell.