Google Colab'dan ilk istek: API anahtarını Secrets'ta tutun

İlk isteğinizi bilgisayarınıza hiçbir şey kurmadan bir Colab not defterinde çalıştırabilirsiniz. Anahtarı Colab Secrets'a kaydedin, userdata.get(...) ile okuyun, openai paketini https://api.cheaptokens.dev/v1 adresine yönlendirin ve choices[0].message.content ile usage değerlerini yazdırın. Anahtar hiçbir zaman bir hücrede durmaz, böylece not defterini paylaşmak anahtarınızı paylaşmak anlamına gelmez.

Son kısım, zahmete değmesinin nedeni. Not defterini bitirip bağlantıyı bir sınıf arkadaşınıza gönderdiğinizi varsayalım. Anahtar bir hücreye yapıştırılmışsa, artık onda da var. Secrets'ta yaşıyorsa, yalnızca kodu alır, başka bir şey almaz.

Bu kılavuz düz requests ile ilk istek üzerine kuruludur. Burada tek yeni şey, anahtarın nerede yaşadığı ve bir not defterinin onu nasıl okuduğudur. Aynı fikrin dizüstü bilgisayardaki hali için anahtarı bir ortam değişkeninde saklama sayfasına bakın.

Neye ihtiyacınız var#

• Bir Google hesabı ve colab.research.google.com adresinde yeni bir not defteri.
• Bir CheapTokens API anahtarı ve bakiyesi yüklenmiş bir hesap. Anahtarlar ve bakiye hesabınızda; dokümanlar tam adımları gösterir.
• Beş dakika.

API, OpenAI Chat Completions ile uyumludur, bu yüzden standart openai Python paketi farklı bir base_url ile çalışır. openai-python README'si (5 Kasım 2026'da kontrol edildi) Python 3.10 veya üstünü ve pip install openai sürümünü listeler.

Anahtarı Colab Secrets'a koyun#

Not defterinin sol kenar çubuğunda Secrets panelini açan bir anahtar simgesi vardır. Yeni bir secret ekleyin, adını CHEAPTOKENS_KEY yapın, değer olarak anahtarınızı yapıştırın ve üzerinde çalıştığınız not defteri için not defteri erişimini açın. Düğmelerin ifadesi değişebilir, bu yüzden bir menü yolu yerine anahtar simgesini arayın.

Adı şimdi seçin: koda geçireceğiniz dize budur. Yanlış bir ad kolayca yapılan bir hatadır ve hatalar bölümü nasıl göründüğünü gösterir.

İlk isteği çalıştırın#

Colab, secret'ları Google'ın colabtools modülündeki bir fonksiyon olan google.colab.userdata.get(name) ile okur (docstring'ler 5 Kasım 2026'da kontrol edildi). SDK'yı kurun, secret'ı okuyun, bir istek gönderin.

!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)

İlk print modelin yanıtını gösterir. İkincisi iki sayı yazdırır: gönderdiğiniz token'lar ve modelin yazdığı token'lar. İsteğin tüm faturası budur, bu yüzden her seferinde yazdırıyoruz.

İsteğin maliyeti#

Ödediğiniz şey token'lardır, bu yüzden çıktının ikinci satırına bakın. Yukarıdaki gibi kısa bir sorunun yaklaşık 40 token girdi kullandığını ve yanıtın 150 token çıktı olduğunu varsayalım. Bu istek mevcut fiyatla $0.000016 tutar ve bunlardan bin tanesi $0.0156 tutar. 40 ve 150'yi not defterinizin yazdırdığı iki sayıyla değiştirin.

DeepSeek-V4-Flash burada bir nedenden dolayı varsayılandır: 380K bağlam, yanıt başına 32.768'e kadar çıktı token'ı ve günün her saatinde tek fiyat, yoğun saat yok. Tek bir bakiye her modeli kapsar, böylece başka hiçbir şeyi değiştirmeden bu hücredeki modeli değiştirebilirsiniz. zai-org/GLM-5.3-Flash deneyin (390K bağlam, 8.192'ye kadar çıktı token'ı) ve hücreyi yeniden çalıştırın. Tam liste için tüm modeller ve fiyatlar sayfasına bakın.

Bir hücre başarısız olduğunda#

Secrets tarafından gelen hatalar önce gelir, herhangi bir istek Colab'dan çıkmadan önce. colabtools kaynağı (5 Kasım 2026'da kontrol edildi) userdata.get fonksiyonunun üç hata fırlatabileceğini söyler.

• SecretNotFoundError: bu ada sahip bir secret yok. userdata.get('...') içindeki dizeyi Secrets panelindeki adla harf harf karşılaştırın. Büyük/küçük harf önemlidir.
• NotebookAccessError: secret var, ancak bu not defterinin ona erişimi yok. Secrets panelinde erişim anahtarını açın ve hücreyi yeniden çalıştırın.
• TimeoutException: Colab, secret isteğine yanıt vermedi. Hata mesajı, secret'ların yalnızca kod Colab arayüzünden çalıştırıldığında alınabileceğini söyler, bu yüzden hücreyi dışa aktarılmış bir betikte değil, Colab not defterinin kendisinde çalıştırın.

Secret yüklenir ve istek hâlâ başarısız olursa, sorun API tarafındadır. Bir 401 anahtarın yanlış veya eksik olduğu anlamına gelir; bir 404 genellikle yanlış bir temel URL'ye veya model kimliğine işaret eder. API 401 veya 404: anahtar, temel URL, model kimliği her ikisini de adım adım anlatır ve GET /v1/models ile modelleri listeleme tam kimliğin nasıl kopyalanacağını gösterir.

Paylaşma ve yenileme#

Not defterini paylaşın, userdata.get çağıran kod da onunla gider; anahtar hiçbir hücrede veya çıktıda yoktur, bu yüzden sızacak bir şey yoktur. Not defterini açan herkesin aynı ada sahip kendi secret'ına ihtiyacı vardır, aksi takdirde SecretNotFoundError alırlar (yukarıya bakın).

Yeni bir anahtar oluşturursanız, Secrets panelindeki değeri güncelleyin; kod aynı kalır çünkü yalnızca secret'ın adını belirtir.

Bir alışkanlık hâlâ önemlidir: anahtarı asla yazdırmayın. print(userdata.get('CHEAPTOKENS_KEY')) gibi bir hücre onu çıktıya koyar ve çıktılar not defteriyle birlikte kaydedilir.

Sonraki adım: yanıtı bir döngüye, bir sohbete veya küçük bir araca koyun. Dokümanlar API'nin geri kalanını kapsar.