Langganan AI dan kunci API: panduan langkah demi langkah

Mulakan dengan istilah

Anda tidak semestinya memerlukan kunci API untuk menulis dek dan belajar. Kunci digunakan untuk penghasilan melalui akaun AI sendiri.

1. Langganan, API dan pas berbeza

API membolehkan perisian meminta AI menjalankan tugas. Kunci API ialah bukti kelayakan rahsia yang membenarkan penggunaan akaun anda. Ia berbeza daripada kod log masuk e-mel, kunci pemulihan Quiz Notebook dan kata laluan chat.

Pengebilan chat dan API berasingan walaupun menggunakan e-mel sama. Anda tidak perlu membeli langganan chat berbayar dahulu untuk menggunakan API. Semak pengebilan akaun API.

2. Pilih cara bekerja

Anda boleh bekerja secara manual dalam chat AI sedia ada, menyemak hasil dan mengimport format yang disokong. Aliran ini berasingan daripada sambungan API.

Dengan BYOK, anda mengurus kunci, model dan kos. Sambungan ini menyokong OpenAI dan Anthropic secara terus. Bukti kelayakan Gemini, NotebookLM, Azure atau Bedrock tidak sesuai untuk medan ini.

Untuk menempah dek siap, jangan hantar kunci peribadi. Perkhidmatan merangkumi penilaian awal, persetujuan skop, semakan dan penyerahan. Semak halaman perkhidmatan untuk pembukaan tempahan berbayar.

3. Persediaan

Sediakan akaun dan pengebilan API, ID model yang boleh digunakan serta contoh ringkas yang anda berhak hantar. Akaun sekolah atau syarikat juga memerlukan kebenaran sambungan perkhidmatan luar.

Aplikasi web memerlukan log masuk e-mel, pas sah dan peranti berdaftar serta aktif dalam tetapan akaun. Kunci tidak membuka fungsi yang belum tersedia.

Jangan masukkan kunci di halaman ini, borang pertanyaan atau e-mel. Gunakan medan terlindung dalam aplikasi rasmi sahaja.

4. Mencipta kunci OpenAI

1. Log masuk ke OpenAI API Platform, berasingan daripada tetapan langganan ChatGPT.
2. Cipta atau pilih projek khas Quiz Notebook dalam organisasi anda untuk memudahkan pemantauan dan pembatalan kunci.
3. Semak API Billing, kaedah bayaran dan kredit. Matikan Auto-reload dan simpan jika tidak mahu pembelian kredit automatik.
4. Dalam API Keys projek, cipta kunci rahsia, beri nama yang jelas dan simpan dalam pengurus kata laluan yang selamat.
5. Hadkan kebenaran kepada yang diperlukan. Sambungan mesti boleh mencipta permintaan Responses API; Read Only tidak mencukupi. Jangan gunakan kunci pentadbir.
6. Dapatkan ID API model yang tepat daripada dokumentasi dan pastikan projek mempunyai akses. Nama pelan atau label chat bukan ID model.

Jika rahsia hilang, cipta pengganti dan batalkan kunci lama. Pengebilan serta kebenaran projek dan model mesti sah.

5. Mencipta kunci Claude / Anthropic

1. Log masuk ke Claude Console, bukan tetapan Claude Pro atau Max.
2. Pilih organisasi dan ruang kerja, sediakan API Billing dan semak kawalan tambah nilai serta perbelanjaan yang tersedia.
3. Cipta kunci inferens di API Keys. Gunakan kunci untuk satu ruang kerja, bukan kunci pentadbir atau bukti kelayakan awan lain.
4. Semak nama, kebenaran dan tarikh luput; simpan rahsia dengan selamat dan catat ruang kerja untuk pemantauan.
5. Cari ID model yang tersedia dalam dokumentasi dan pilih Anthropic dalam Quiz Notebook.

Langganan Claude berbayar tidak menggantikan baki atau pengebilan API Console.

6. Menyambung dalam Quiz Notebook

1. Log masuk ke aplikasi rasmi dan semak pas serta peranti aktif dalam tetapan.
2. Pilih dek; mulakan dengan satu atau dua soalan dan jawapan ringkas yang ditulis sendiri.
3. Buka ‘내 API로 AI 후보 만들기’ (Cipta calon dengan API saya) di bawah dek. Medan ini bukan dalam tetapan akaun.
4. Pilih OpenAI atau Anthropic, masukkan ID model tepat dan kunci dalam ‘본인 API 키’. Buang ruang atau baris baharu berlebihan.
5. Baca dan setujui notis penghantaran serta caj berasingan. Teks soalan dan jawapan dek dihantar; imej dan lampiran tidak dibaca secara automatik.
6. Tekan sekali ‘별도 후보 덱 만들기’ (Cipta dek calon berasingan) dan tunggu. Memasukkan kunci sahaja tidak memanggil AI.
7. Semak dek berasingan dengan sumber: ketepatan, penerangan dan hak. Ia tidak digabungkan automatik dengan asal atau disemak melalui perkhidmatan penghasilan tempahan.
8. Semak Usage dan Billing penyedia sebelum menambah jumlah bahan.

7. Ke mana kunci dan bahan dihantar?

Laluannya ialah pelayar → pelayan Quiz Notebook → penyedia AI dipilih → pelayar. Pelayan mengendalikan kunci buat sementara dalam memori; bukan sambungan terus kepada penyedia sahaja.

Pelaksanaan semasa tidak menyimpan kunci secara kekal dalam pangkalan data akaun atau storan pelayar dan tidak sengaja merekodkan badan permintaan dalam log. Muat semula atau log keluar memadam kunci pada skrin. Ini bukan jaminan tiada penyimpanan oleh penyedia AI.

Penyegerakan peribadi disulitkan berbeza daripada menghantar teks boleh dibaca kepada AI. Buang nama, butiran hubungan dan rekod pelajar yang tidak diperlukan serta semak hak penggunaan dan penghantaran.

8. Mengawal kos

Kos bergantung pada model, token input dan output serta jumlah panggilan. Token tidak sama dengan aksara. Sumber panjang, jawapan panjang dan pengulangan boleh menambah kos.

Anggarkan token input × kadar input + token output × kadar output mengikut unit harga rasmi. Semak cache, penaakulan, cukai dan kadar tukaran. Pas web ialah kos berasingan.

Amaran belanja OpenAI tidak menghentikan panggilan. Semak dan simpan ‘Enforce a hard limit’ dalam Limits jika mahu had dikuatkuasakan. Kelewatan boleh menyebabkan sedikit lebihan. Had tambah nilai automatik mengawal pembelian kredit, bukan belanja API.

Dalam Claude Console, semak penggunaan organisasi/ruang kerja dan pengebilan. Mulakan kecil; semak amaran, had dan tambah nilai secara berasingan.

9. Memutuskan, mengganti atau membatalkan

1. ‘입력한 API 키 지우기’ (Padam kunci yang dimasukkan) memadam kunci serta persetujuan pada skrin. Permintaan yang sedang berjalan tidak dibatalkan.
2. Untuk menyekat penggunaan seterusnya di tempat lain, batalkan atau padam kunci melalui API Keys penyedia. Mengosongkan medan tidak membatalkan kunci.
3. Gunakan kunci baharu apabila menyambung semula. Jika disyaki bocor, batalkan yang lama dahulu dan semak Usage serta Billing.
4. Urus langganan chat, tambah nilai API dan pas Quiz Notebook secara berasingan. Membatalkan satu tidak membatalkan yang lain.

Untuk bantuan, berikan masa, penyedia, ID model dan tangkap layar tanpa rahsia. Jangan hantar kunci penuh.

10. Menyelesaikan masalah

Butang tidak aktif: semak ketersediaan, log masuk, pas, persetujuan dan permintaan yang berjalan. Untuk ralat peranti, semak pendaftaran dan pengaktifan.

Ralat kunci/model: semak penyedia, ruang, tarikh luput, pembatalan, kebenaran dan ID tepat. Bayaran chat tidak menambah baki API.

Kuota atau kesesakan: semak baki, had kadar dan belanja. Kredit baharu mungkin lambat dipaparkan. Jangan membeli berulang kali sebelum mengenal pasti punca.

Tamat masa atau format tidak sah: tiada percubaan semula automatik. Penyedia mungkin telah melakukan kerja bercaj. Semak Usage sebelum mencuba dengan teks lebih pendek.

Kandungan salah: sambungan berjaya bukan pengesahan jawapan. Betulkan atau buang calon tanpa asas sumber.

11. Perkongsian, hak dan organisasi

Jangan kongsi kunci dengan rakan atau pelajar: caj mungkin dikenakan kepada akaun sama. Pelaksanaan institusi memerlukan persetujuan pemilikan akaun, kebenaran dan kos. Jangan lampirkan kunci atau data pelajar sebenar dalam pertanyaan.

Kami mencadangkan penggunaan untuk pembelajaran peribadi. Semak hak sebelum menghantar buku atau nota pihak lain kepada AI luar, menerbitkan atau menjual hasil. Privasi tidak menghapuskan isu hak cipta secara automatik.

Kunci API membenarkan panggilan AI; kod e-mel mengesahkan log masuk; kunci pemulihan membuka dek disulitkan. Ketiga-tiganya tidak boleh ditukar ganti.

12. Soalan lazim

Adakah memasukkan kunci dicaj? Input sahaja tidak menghantar permintaan. Penghasilan boleh dicaj apabila diproses penyedia.

Adakah hasil sama seperti chat? Model, arahan, tetapan dan alat boleh berbeza. Carian dan lampiran chat tidak disertakan secara automatik.

Perlu masukkan semula? Ya selepas muat semula atau log keluar kerana kunci tidak disimpan kekal. Kekal log masuk ialah perkara berasingan.

Adakah aplikasi terpasang mempunyai menu sama? Panduan ini untuk web. Semak manual versi tablet dan desktop untuk aliran serta ketersediaannya.