Permintaan pertama dari Google Colab: simpan kunci API di Secrets

Anda dapat menjalankan permintaan pertama Anda di notebook Colab tanpa menginstal apa pun di komputer Anda. Simpan kunci di Colab Secrets, baca dengan userdata.get(...), arahkan paket openai ke https://api.cheaptokens.dev/v1, dan cetak choices[0].message.content dan usage. Kunci tidak pernah berada di dalam sel, jadi membagikan notebook tidak membagikan kunci Anda.

Bagian terakhir itulah alasan untuk repot-repot. Katakanlah Anda menyelesaikan notebook dan mengirim tautannya ke teman sekelas. Jika kunci ditempel di dalam sel, mereka sekarang memilikinya. Jika kunci berada di Secrets, mereka hanya mendapatkan kodenya dan tidak yang lain.

Panduan ini dibangun di atas permintaan pertama dengan requests biasa. Di sini satu-satunya hal baru adalah di mana kunci berada dan bagaimana notebook membacanya. Untuk ide yang sama di laptop, lihat menyimpan kunci di variabel lingkungan.

Yang Anda butuhkan#

• Akun Google dan notebook baru di colab.research.google.com.
• Kunci API CheapTokens dan saldo yang sudah diisi. Kunci dan saldo ada di akun Anda; dokumentasi menunjukkan langkah-langkah persisnya.
• Lima menit.

API ini kompatibel dengan OpenAI Chat Completions, jadi paket Python openai standar berfungsi dengan base_url yang berbeda. README openai-python (diperiksa 5 November 2026) mencantumkan Python 3.10 atau lebih tinggi dan pip install openai.

Letakkan kunci di Colab Secrets#

Di bilah sisi kiri notebook ada ikon kunci, yang membuka panel Secrets. Tambahkan secret baru, beri nama CHEAPTOKENS_KEY, tempel kunci Anda sebagai nilainya, dan aktifkan akses notebook untuk notebook yang sedang Anda kerjakan. Kata-kata pada tombol bisa berubah, jadi carilah ikon kunci alih-alih jalur menu.

Pilih nama yang Anda inginkan sekarang: itulah string yang akan Anda berikan ke kode. Nama yang salah adalah kesalahan yang mudah terjadi, dan bagian error menunjukkan bagaimana tampilannya.

Jalankan permintaan pertama#

Colab membaca secret dengan google.colab.userdata.get(name), sebuah fungsi di modul colabtools milik Google (docstring diperiksa 5 November 2026). Instal SDK, baca secret, kirim satu permintaan.

!pip install -q openai

from google.colab import userdata
from openai import OpenAI

client = OpenAI(
    api_key=userdata.get('CHEAPTOKENS_KEY'),
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain a token in one sentence.'}],
    max_tokens=200,
)
print(resp.choices[0].message.content)
print(resp.usage.prompt_tokens, resp.usage.completion_tokens)

print pertama menampilkan jawaban model. Yang kedua mencetak dua angka: token yang Anda kirim dan token yang ditulis model. Itulah seluruh tagihan untuk permintaan tersebut, itulah sebabnya kami mencetaknya setiap kali.

Berapa biaya permintaannya#

Token adalah yang Anda bayar, jadi lihat baris kedua output. Katakanlah pertanyaan singkat seperti di atas menggunakan sekitar 40 token masuk dan jawabannya 150 token keluar. Permintaan itu berbiaya $0.000016 pada harga saat ini, dan seribu permintaan berbiaya $0.0156. Ganti 40 dan 150 dengan dua angka yang dicetak notebook Anda.

DeepSeek-V4-Flash adalah default di sini karena suatu alasan: konteks 380K, hingga 32.768 token output per jawaban, dan satu harga kapan pun sepanjang hari, tanpa jam sibuk. Satu saldo mencakup semua model, jadi Anda dapat menukar model di sel ini tanpa mengubah apa pun yang lain. Coba zai-org/GLM-5.3-Flash (konteks 390K, hingga 8.192 token output) dan jalankan sel lagi. Lihat semua model dan harga untuk daftar lengkapnya.

Ketika sel gagal#

Error dari sisi secrets muncul lebih dulu, sebelum permintaan apa pun meninggalkan Colab. Sumber colabtools (diperiksa 5 November 2026) menyatakan userdata.get dapat memunculkan tiga error.

• SecretNotFoundError: tidak ada secret dengan nama itu. Bandingkan string di userdata.get('...') dengan nama di panel Secrets, huruf demi huruf. Huruf besar-kecil berpengaruh.
• NotebookAccessError: secret ada, tetapi notebook ini tidak memiliki akses ke sana. Aktifkan toggle akses di panel Secrets dan jalankan ulang sel.
• TimeoutException: Colab tidak menjawab permintaan untuk secret. Pesan error menyatakan secret hanya dapat diambil ketika kode dijalankan dari UI Colab, jadi jalankan sel di notebook Colab itu sendiri, bukan di skrip yang diekspor.

Jika secret berhasil dimuat dan permintaan tetap gagal, masalahnya ada di sisi API. 401 berarti kunci salah atau hilang; 404 biasanya menunjuk ke base URL atau id model yang salah. API 401 atau 404: kunci, base URL, id model membahas keduanya, dan mendaftar model dengan GET /v1/models menunjukkan cara menyalin id yang tepat.

Berbagi dan rotasi#

Bagikan notebook dan kode yang memanggil userdata.get ikut bersamanya; kunci tidak ada di sel atau output mana pun, jadi tidak ada yang bocor. Siapa pun yang membuka notebook memerlukan secret mereka sendiri dengan nama yang sama, jika tidak mereka mendapatkan SecretNotFoundError (lihat di atas).

Jika Anda membuat kunci baru, perbarui nilainya di panel Secrets; kodenya tetap sama karena hanya menyebut nama secret.

Satu kebiasaan tetap penting: jangan pernah mencetak kunci. Sel seperti print(userdata.get('CHEAPTOKENS_KEY')) menaruhnya ke output, dan output disimpan bersama notebook.

Langkah berikutnya: masukkan jawaban ke dalam loop, chat, atau alat kecil. Dokumentasi mencakup sisa API.