API TypeSafe

Endpoint evaluasi HTTP

Badan permintaan memiliki tiga kolom tingkat teratas. state wajib diisi dan dapat berupa string, objek, atau larik teks. model juga wajib; contoh dokumentasi memakai jev-latest. questions adalah pemetaan objek Question bertipe. Anda menentukan setiap kuncinya. Jawaban yang sesuai dikembalikan dengan id yang sama. Kunci tersebut tidak dikirim ke model yang mendasarinya dan tidak digunakan saat inferensi.

Noul minimal tampak seperti {"state": "Tolong! Pembayaran saya gagal selama 3 hari.", "model": "jev-latest", "questions": {"is_urgent": {"type": "noul", "instructions": "Apakah ini menunjukkan urgensi?"}}}. Choice menambahkan pemetaan kriteria dari nama opsi ke deskripsi. Score menambahkan larik kriteria tingkat yang berurutan. Ketiganya sama-sama memiliki type dan instructions; masing-masing menambahkan bentuk criteria tersendiri.

Dapatkan kunci API dari https://console.typesafe.ai/settings/keys. Jika memanggil HTTP secara langsung, tangani 429 dengan retry-after. Batas laju untuk Jev 1.13 adalah 250,000 token per detik dan 1,200 permintaan per menit, serta dapat berubah tanpa pemberitahuan. Secara default, SDK mencoba lagi dengan jeda bertahap. Daftar model tersedia melalui GET /v1/models dengan token Bearer yang sama.

SDK resmi

Python: pip install typesafe-sdk. Impor TypeSafeClient dari typesafe_sdk. Gunakan TypeSafeClient() sebagai klien: client.system_one(state, questions). Konstruktor seperti Noul, Choice, dan Score tersedia dalam paket sehingga Anda tidak perlu menulis sendiri kolom jenis JSON. Model bawaannya adalah jev-latest. Memerlukan Python 3.10 atau yang lebih baru.

JavaScript: npm install @typesafe-ai/sdk. Impor { TypeSafeClient } dari "@typesafe-ai/sdk". Klien berkomunikasi dengan endpoint yang sama. Runtime-nya adalah Node.js 20+. Repositorinya ada di https://github.com/typesafe-ai/typesafe-sdk-js. Kedua SDK menyediakan models.list() untuk katalog alias.

Playground di https://console.typesafe.ai/playground merupakan konsol yang mengharuskan login, bukan sematan publik. Tempelkan teks sebagai state, tambahkan Noul seperti "Apakah pesan ini menunjukkan urgensi?", lalu gabungkan pertanyaan lain dalam satu panggilan. Ini cara tercepat untuk mencoba evaluasi paralel sebelum memasang kunci produksi.

curl pertama

Gunakan curl -X POST https://api.typesafe.ai/v1/systemone dengan Authorization: Bearer $TYPESAFE_API_KEY dan Content-Type: application/json. Badannya: state berupa pesan kegagalan Stripe-connect, model jev-latest, serta questions.urgency bertipe noul dengan instructions "Apakah pesan ini menunjukkan urgensi?". Itulah contoh mulai cepat. Tambahkan Choice bernama department dengan kriteria billing / technical / sales, dan Score bernama frustration dengan tingkat berurutan, tanpa perjalanan bolak-balik kedua.

Jika ada yang gagal, baca jaggedness sebelum menambahkan penjelasan ke instruksi. Pembacaan literal memerlukan syarat yang persis dalam instruksi dan kriteria. Perhitungan harus dilakukan dalam kode. Pembuatan teks memerlukan model lain. API tetap akan mengembalikan payload bertipe jika Anda meminta Jev menulis paragraf melalui rangkaian Choice; hasilnya akan lambat dan buruk. Gunakan regex atau model generatif untuk mengusulkan opsi, lalu biarkan Jev memilih.

Cloudflare Workers AI mencantumkan typesafe/jev sebagai nama katalog. Itu adalah pencantuman pihak ketiga, bukan pengganti api.typesafe.ai. Steam tidak memiliki aplikasi Jev. Simpan kunci di konsol milik TypeSafe dan anggap SDK komunitas di Awesome Jev tidak resmi kecuali mengikuti organisasi github.com/typesafe-ai.

Kesalahan, percobaan ulang, dan ID

429 Too Many Requests adalah respons terdokumentasi saat Anda melampaui batas token per detik atau permintaan per menit. Patuhi retry-after. SDK resmi sudah menerapkan jeda bertahap. Jika membungkus HTTP sendiri, jangan terus membombardir endpoint saat menerima 429; Anda akan tetap berada dalam jendela batas yang sama.

ID pertanyaan digunakan untuk rekam jejak Anda. ID tersebut tidak pernah masuk ke inferensi. Anda dapat membuat item_0 hingga item_n dalam perulangan dan tetap mendapatkan satu Noul untuk masing-masing. Pastikan kunci tersebut unik dalam satu permintaan. Pemakaian ulang kunci akan menimpa pertanyaan dalam pemetaan tanpa peringatan.

Otorisasi memakai kunci API Bearer TypeSafe dari dasbor. Tidak ada sesi cookie di api.typesafe.ai. Rotasikan kunci melalui konsol, bukan dengan mengirim surel ke wiki ini. Pembatas login playground adalah hal terpisah: itu konsol peramban, bukan API HTTP alternatif.

Salin curl mulai cepat satu kali, lalu hapus dari repositori Anda dan gunakan SDK. SDK menangani percobaan ulang dan konstruktor bertipe. HTTP mentah ditujukan bagi bahasa tanpa klien resmi. Kedua cara tetap mengirim kunci Bearer dan badan JSON yang sama ke POST /v1/systemone.

GET /v1/models menampilkan alias yang dapat dikirim oleh akun Anda. Daftar itu mungkin tidak memuat jev-1.13.0 meski ID tersebut berfungsi pada POST /v1/systemone. Jangan anggap daftar itu sebagai daftar izin untuk ID berversi. Perlakukan sebagai katalog alias dan simpan ID berversi dalam konfigurasi Anda sendiri.

Jangan pernah commit TYPESAFE_API_KEY. Rotasikan melalui dasbor jika bocor. contact@jevai.wiki bukan alamat yang tepat untuk melaporkan rahasia yang bocor—gunakan kanal milik TypeSafe sendiri.

Python 3.10 dan Node.js 20 adalah versi minimum yang terdokumentasi. Runtime yang lebih lama tidak didukung klien resmi.