Langganan AI dan kunci API: panduan langkah demi langkah

Mulai dari istilah

Anda tidak selalu memerlukan kunci API untuk menulis dek dan belajar. Kunci dibutuhkan saat membuat hasil dengan akun AI sendiri.

1. Langganan, API dan akses web berbeda

API adalah cara perangkat lunak meminta AI melakukan pekerjaan. Kunci API adalah kredensial rahasia yang mengizinkan penggunaan akun Anda. Ini berbeda dari kode masuk email, kunci pemulihan Quiz Notebook, dan kata sandi chat.

Tagihan chat dan API terpisah walaupun emailnya sama. Anda tidak harus membeli langganan chat berbayar terlebih dahulu untuk memakai API. Periksa pengaturan tagihan akun API.

2. Pilih alur kerja

Anda dapat bekerja secara manual di chat AI yang biasa digunakan, meninjau hasilnya, lalu mengimpor format yang didukung. Alur ini berbeda dari koneksi API.

Dengan BYOK, Anda mengatur kunci, model dan biaya. Koneksi ini mendukung OpenAI dan Anthropic secara langsung. Kredensial Gemini, NotebookLM, Azure atau Bedrock tidak cocok untuk kolom ini.

Untuk memesan dek jadi, jangan kirim kunci pribadi. Layanan produksi mencakup penilaian awal, kesepakatan lingkup, peninjauan dan penyerahan. Periksa halaman layanan untuk status pembukaan pesanan berbayar.

3. Sebelum menghubungkan

Siapkan akun dan tagihan API, ID model yang dapat diakses, serta contoh singkat yang berhak Anda kirim. Akun sekolah atau perusahaan juga memerlukan izin menghubungkan layanan luar.

Aplikasi web memerlukan login email, akses yang berlaku, dan perangkat terdaftar serta aktif di pengaturan akun. Membuat kunci tidak membuka fitur yang belum tersedia.

Jangan masukkan kunci di halaman panduan, formulir kontak atau email. Gunakan hanya kolom tersamar di aplikasi resmi.

4. Membuat kunci OpenAI

1. Masuk ke OpenAI API Platform, terpisah dari pengaturan langganan ChatGPT.
2. Buat atau pilih proyek khusus Quiz Notebook dalam organisasi Anda agar pemantauan dan pencabutan mudah.
3. Periksa API Billing, metode bayar dan kredit. Matikan Auto-reload dan simpan jika tidak ingin pembelian kredit otomatis.
4. Pada API Keys proyek, buat kunci rahasia baru dengan nama yang jelas dan simpan dalam pengelola kata sandi yang aman.
5. Batasi izin sesuai kebutuhan. Koneksi ini harus dapat membuat permintaan Responses API; Read Only tidak cukup. Jangan gunakan kunci admin.
6. Cari ID API model yang tepat di dokumentasi dan pastikan proyek berhak menggunakannya. Nama paket atau label chat bukan ID model.

Jika rahasia hilang, buat pengganti dan cabut kunci lama. Tagihan serta izin proyek dan model harus valid.

5. Membuat kunci Claude / Anthropic

1. Masuk ke Claude Console, bukan pengaturan Claude Pro atau Max.
2. Pilih organisasi dan workspace, siapkan API Billing dan periksa kontrol pengisian serta pengeluaran yang tersedia.
3. Buat kunci inferensi di API Keys. Gunakan kunci untuk satu workspace, bukan kunci admin atau kredensial cloud lain.
4. Periksa nama, izin dan masa berlaku; simpan rahasianya dengan aman dan catat workspace untuk pemantauan pemakaian.
5. Cari ID model yang tersedia di dokumentasi, lalu pilih Anthropic di Quiz Notebook.

Langganan Claude berbayar tidak menggantikan saldo atau pengaturan tagihan API Console.

6. Menghubungkan di Quiz Notebook

1. Masuk ke aplikasi resmi dan periksa paket akses serta perangkat aktif di pengaturan.
2. Pilih dek. Mulailah dengan satu atau dua pertanyaan dan jawaban pendek yang Anda tulis sendiri.
3. Buka ‘내 API로 AI 후보 만들기’ (Buat kandidat dengan API saya) di bawah dek. Kolom ini bukan bagian pengaturan akun.
4. Pilih OpenAI atau Anthropic, isi ID model tepat dan kunci di ‘본인 API 키’. Hapus spasi serta baris baru tambahan.
5. Baca dan setujui pemberitahuan pengiriman serta biaya terpisah. Teks pertanyaan dan jawaban dek dikirim; gambar dan lampiran tidak dibaca otomatis.
6. Tekan sekali ‘별도 후보 덱 만들기’ (Buat dek kandidat terpisah), lalu tunggu. Memasukkan kunci saja tidak memanggil AI.
7. Periksa dek terpisah terhadap sumber: ketepatan, penjelasan dan hak. Dek tidak digabung otomatis ke aslinya dan tidak melalui peninjauan layanan produksi pesanan.
8. Periksa Usage dan Billing penyedia sebelum menambah volume materi.

7. Ke mana kunci dan materi dikirim?

Alurnya adalah browser → server Quiz Notebook → penyedia AI pilihan → browser. Server menangani kunci sementara dalam memori; bukan koneksi langsung browser-ke-penyedia saja.

Implementasi saat ini tidak menyimpan kunci secara permanen dalam basis data akun atau penyimpanan browser, dan tidak sengaja mencatat isi permintaan dalam log. Muat ulang atau keluar menghapus kunci di layar. Ini tidak menjamin penyedia AI sama sekali tidak menyimpan data.

Sinkronisasi privat terenkripsi berbeda dari pengiriman teks yang dapat dibaca AI. Hapus nama, kontak dan catatan siswa yang tidak diperlukan; pastikan hak penggunaan dan pengiriman.

8. Mengendalikan biaya

Biaya bergantung pada model, token input dan output serta jumlah panggilan. Token tidak sama dengan karakter. Sumber panjang, jawaban panjang dan pengulangan dapat menambah biaya.

Perkirakan token input × tarif input + token output × tarif output sesuai satuan tarif resmi. Periksa cache, penalaran, pajak dan kurs. Akses web adalah biaya terpisah.

Peringatan belanja OpenAI tidak menghentikan panggilan. Periksa dan simpan ‘Enforce a hard limit’ di Limits jika ingin pembatasan. Penundaan penerapan dapat menyebabkan sedikit kelebihan. Batas isi ulang otomatis membatasi pembelian kredit, bukan belanja API.

Di Claude Console periksa pemakaian organisasi/workspace dan tagihan. Mulai kecil, lalu periksa peringatan, batas dan isi ulang secara terpisah.

9. Memutus, mengganti atau membatalkan

1. ‘입력한 API 키 지우기’ (Hapus kunci yang dimasukkan) menghapus kunci dan persetujuan di layar. Permintaan yang sudah berjalan tidak dibatalkan.
2. Untuk mencegah pemakaian berikutnya di tempat lain, cabut atau hapus kunci melalui API Keys penyedia. Mengosongkan kolom tidak mencabutnya.
3. Gunakan kunci baru saat menghubungkan kembali. Jika diduga bocor, cabut kunci lama terlebih dahulu dan periksa Usage serta Billing.
4. Kelola langganan chat, isi ulang API dan akses Quiz Notebook secara terpisah. Membatalkan salah satu tidak membatalkan yang lain.

Untuk bantuan, sertakan waktu, penyedia, ID model dan tangkapan layar tanpa rahasia. Jangan kirim kunci lengkap.

10. Pemecahan masalah

Tombol nonaktif: periksa ketersediaan, login, akses, persetujuan dan permintaan yang berjalan. Untuk kesalahan perangkat, periksa registrasi dan aktivasi.

Kesalahan kunci/model: periksa penyedia, spasi, kedaluwarsa, pencabutan, izin dan ID tepat. Pembayaran chat tidak menambah saldo API.

Kuota atau kesibukan: periksa saldo, batas kecepatan dan belanja. Kredit baru mungkin terlambat tampil. Jangan membeli berulang kali sebelum menemukan penyebabnya.

Waktu habis atau format tidak valid: tidak ada percobaan ulang otomatis. Penyedia mungkin telah melakukan pekerjaan berbayar. Periksa Usage sebelum mencoba kembali dengan teks lebih pendek.

Isi salah: koneksi berhasil bukan validasi kebenaran. Koreksi atau buang kandidat tanpa dasar sumber.

11. Berbagi, hak dan organisasi

Jangan berbagi kunci dengan teman atau siswa: panggilan dapat dibebankan ke akun yang sama. Penerapan institusi memerlukan kesepakatan kepemilikan akun, izin dan biaya. Jangan lampirkan kunci atau data siswa nyata pada permintaan informasi.

Kami menyarankan penggunaan untuk belajar pribadi. Periksa hak sebelum mengirim buku atau catatan orang lain ke AI luar, menerbitkan atau menjual hasil. Privasi tidak otomatis menyelesaikan masalah hak cipta.

Kunci API mengizinkan panggilan AI; kode email mengautentikasi login; kunci pemulihan membuka dek terenkripsi. Ketiganya tidak dapat saling menggantikan.

12. Pertanyaan umum

Apakah memasukkan kunci langsung berbayar? Memasukkannya saja tidak mengirim permintaan. Pembuatan dapat ditagih saat penyedia memprosesnya.

Apakah hasilnya sama dengan chat? Model, instruksi, pengaturan dan alat bisa berbeda. Pencarian dan lampiran chat tidak otomatis termasuk.

Harus memasukkan ulang? Ya setelah muat ulang atau keluar, karena kunci tidak disimpan permanen. Tetap login berbeda dari menyimpan kunci.

Apakah aplikasi terpasang memiliki menu yang sama? Panduan ini untuk web. Periksa manual versi tablet atau desktop untuk alur dan status ketersediaannya.