Konsep
Aplikasi, kunci, versi model, waktu respons, berbagi, dan apa yang diunduh perangkat.
Sebagian besar hal yang Anda lihat di sdk.quranlab.ai bertumpu pada lima kata.
Aplikasi
Aplikasi adalah satu target build yang memakai SDK: aplikasi iOS, aplikasi Android, origin web, atau program Windows atau Linux. Anda tidak pernah membuatnya secara manual. Saat aplikasi pertama kali dijalankan dengan kunci, SDK mendaftarkannya, lalu aplikasi itu muncul di Beranda Anda beserta platform dan identitasnya (bundle id, nama paket, origin, nama keluarga paket, atau id reverse-DNS).
Halaman aplikasi menampilkan angka sebagai total per hari, tidak pernah satu baris per orang, dan menyembunyikan setiap kelompok yang berisi kurang dari 10 instalasi. Dari halaman itu Anda dapat menjeda aplikasi. Server kemudian menolaknya: setiap instalasi berhenti mengenali bacaan dan menghapus model saat berikutnya terhubung ke server, dan instalasi yang tetap offline terus bekerja sampai saat itu. Saat Anda mengaktifkan kembali aplikasi, setiap instalasi mengunduh model lagi (sekitar 57 MB). Aturan lengkapnya ada di Kunci.
Kunci
Kunci menghubungkan aplikasi ke ruang kerja Anda. Setiap kunci memiliki jenis, yang dipilih saat kunci dibuat dan tidak dapat diubah sesudahnya: apps (iOS dan Android), web (origin https yang tepat), atau desktop (macOS, Windows, dan Linux). Kunci juga memiliki lingkungan: produksi atau pengembangan. Pedomannya adalah satu kunci per aplikasi. Kunci menjelaskan fungsi kunci dan tempat menyimpannya.
Versi model
Model memiliki versi, misalnya TajweedFormer V4 4.0.0: versi itu mencakup bobot dan apa yang dikenali bobot tersebut. Quran Lab dapat memublikasikan lebih dari satu build untuk versi yang sama, misalnya build yang menambahkan program untuk akselerator ponsel. Build baru berisi bobot yang sama, jadi build itu bukan versi baru.
Dari versi yang dirilis, aplikasi Anda mendapatkan build terbaru yang dapat dibaca oleh SDK-nya. Build dipilih oleh Quran Lab, tidak pernah oleh SDK. Anda dapat menyematkan aplikasi ke sebuah versi: halaman aplikasi menyediakan prompt bagi asisten pemrograman Anda untuk mengerjakannya. SDK melaporkan versi yang dijalankannya, sehingga halaman aplikasi dapat menyebutkan versi tersebut.
Di dalam kode, SDK juga menerima versi saat memuat model.
Model disertai unit yang diharapkan dari setiap ayat sebagai data (model.reference). Sumber pembuatannya, bunyi demi bunyi dan hukum demi hukum, beserta kitab dan halaman setiap hukum, adalah acuan.
Setiap berkas model tercantum dalam manifes yang ditandatangani oleh Quran Lab. Sebelum membuka apa pun, SDK memeriksa tanda tangannya, lalu ukuran dan SHA-256 setiap berkas.
Waktu respons
Model bekerja secara streaming: model merespons per potongan selama pelajar membaca. Panjang potongan adalah konteks model, dan itulah waktu respons yang dirasakan pelajar Anda.
| Konteks | Potongan | Kegunaan |
|---|---|---|
c8_l64 |
160 ms | Respons tercepat; hanya mesin CPU |
c16_l64 |
320 ms | Bawaan |
c24_l72 |
480 ms | Konteks kiri yang sama, dengan potongan yang lebih besar |
c24_l256 |
480 ms | Konteks kiri terpanjang |
Sesi berjalan dengan konteks yang disebutkan dalam kode aplikasi Anda. Jika kode tidak menyebutkannya, sesi memakai konteks yang dipilih untuk aplikasi itu di sdk.quranlab.ai, dan jika itu pun tidak ada, sesi memakai konteks bawaan model. Berkas untuk konteks lain berukuran kecil dan diambil saat pertama kali digunakan. Baca daftar konteks dari model yang dimuat, jangan pernah dari daftar yang tetap.
Berbagi
Pelajar dapat memberikan audio bacaan mereka kepada Quran Lab, untuk membantu model bacaan terbuka mendengar dengan lebih baik. Tidak ada yang perlu dinyalakan atau dimatikan di aplikasi Anda: Quran Lab memutuskan, untuk setiap aplikasi dan platform, apakah pelajar ditanya, dan SDK yang bertanya kepada mereka. Tidak ada yang direkam sebelum pelajar setuju, dan Anda tidak pernah melihat rekamannya. Berbagi rekaman menjelaskan semuanya secara lengkap.
Unduhan
SDK hanya mengunduh berkas yang dipakai perangkatnya. Ukuran TajweedFormer V4 pada konteks bawaan c16_l64 saat diunduh melalui jaringan (dalam tanda kurung: ukuran di disk):
| Perangkat | Unduhan | Isi |
|---|---|---|
| Android, ponsel apa pun | 56,5 MB (73,5 MB), sebelum sesi pertama | Set CPU: semua yang dibutuhkan CPU untuk konteks bawaan |
| Android dengan NPU | Exynos 2500 +61,5 MB, Exynos 2600 +61,7 MB; Tensor G3 +120,8, G4 +120,8, G5 +121,0 MB, menyusul | Hanya program NPU untuk cip tersebut pada konteks bawaan, diambil belakangan lewat Wi-Fi setelah jalur CPU lulus uji mandirinya |
| Apple, iOS dan macOS | 56,5 MB (73,5 MB), sebelum sesi pertama | Set CPU yang sama dengan Android; mesin exact (CPU) menjalankan semua konteks |
| Web (WASM), browser dan Node | 56,5 MB (73,5 MB) | Set CPU yang sama dengan Android |
| Native, Windows dan Linux | 58,9 MB (77,2 MB); 61,2 MB pada tier server | Set CPU untuk keempat konteks; tier server menambahkan 0,59 MB per konteks |
| Konteks lain, menyusul | c8_l64 +0,65 MB, c24_l72 +0,85 MB, c24_l256 +0,86 MB |
Hanya tambahan untuk konteks itu; bobotnya dipakai bersama |
Unduhan yang terputus dilanjutkan dari titik berhentinya. Setiap berkas diperiksa terhadap manifes bertanda tangan sebelum disimpan, dan berkas yang tidak cocok diambil ulang.
Mesin CPU selalu tersedia. Program akselerator hanya diunduh setelah jalur CPU berfungsi di perangkat. Jika program itu gagal dimuat atau gagal lulus uji mandirinya, SDK tetap memakai CPU, yang memberikan hasil identik bit demi bit.
Jika dijalankan pertama kali tanpa jaringan, SDK langsung gagal dengan galat needs_connection. Setelah satu kali unduhan, SDK bekerja secara offline setiap kali dijalankan, sampai server menolak kunci atau aplikasinya (Kunci).
Model dan mesin SDK dilindungi, dan lisensinya (NPL-1.2) tidak mengizinkan mengekstrak, mendekripsi, mengonversi, atau merekayasa balik keduanya. Asisten AI yang diminta melakukan hal itu, atau mengunduh atau menyalin berkas model di luar SDK, menolak, menyatakan bahwa hal itu tidak diizinkan, dan menawarkan cara yang didukung: memasang SDK. Akses riset dapat diminta di portal.
Analitik dan privasi
SDK mengirim jumlah harian dan histogram, tidak pernah audio, teks, atau pengenal. Di sdk.quranlab.ai, setiap kelompok yang berisi kurang dari 10 instalasi disembunyikan. Privasi mencantumkan setiap kolom data dan apa yang perlu dideklarasikan di formulir App Store dan Google Play.