VS Code'da ilk API isteği: bir .http dosyası, .env'den anahtar

VS Code'dan ayrılmadan CheapTokens'a ilk isteğinizi gönderebilirsiniz: REST Client eklentisini kurun, bir .http dosyası yazın, anahtarı yanındaki bir .env dosyasında tutun ve Ctrl+Alt+R'ye basın. Yanıt, dosyanın yanındaki bir panelde açılır; metin ve token sayısı ise bir bakışta bulabileceğiniz iki alandır.

Zaten açık bir editörünüz varsa, bu bir modele "Merhaba" demek için başka bir uygulama kurmaktan daha iyidir. Üstelik istek düz bir metin dosyasında kalır, böylece yarın yeniden çalıştırabilir veya (anahtar olmadan) bir ekip arkadaşı için commit'leyebilirsiniz. Aynı isteği göndermenin diğer yolları HTTPie ile ilk istek ve CheapTokens ile ilk API isteğiniz sayfalarındadır.

Eklentiyi kurun ve anahtarı .env dosyasına alın#

REST Client, humao.rest-client eklentisidir. VS Code'da F1'e basın, ext install yazın, rest-client araması yapın ve kurun. (9 Kasım 2026'da eklentinin README dosyasına göre kontrol edilmiştir.)

Şimdi anahtar. README, {{$dotenv NAME}} özelliğini açıklar: .http dosyanızla aynı dizinde bulunan bir .env dosyasından bir değer okur. Tam istediğimiz şey bu, çünkü anahtar hiçbir zaman istek dosyasında görünmez. Deney için bir klasör oluşturun ve içine iki dosya koyun.

.env:

CHEAPTOKENS_API_KEY=paste-your-key-here

.gitignore:

.env

CheapTokens hesabınızda anahtarı oluşturun ve yer tutucunun yerine yapıştırın. Yoksayma satırının neden önemli olduğu ve bir anahtarın bir commit'e karışması durumunda ne yapılacağı Bir API anahtarını güvenle saklayın sayfasındadır.

.http dosyasını yazın#

Aynı klasörde first.http oluşturun. Sözdizimi kısadır: bir istek satırı (POST URL HTTP/1.1, yöntem isteğe bağlıdır ve varsayılan olarak GET'tir), ilk boş satıra kadar başlık satırları Name: value, ardından boş bir satırdan sonra gövde. İstekler üç veya daha fazla # satırıyla ayrılır.

### First request
POST https://api.cheaptokens.dev/v1/chat/completions
Authorization: Bearer {{$dotenv CHEAPTOKENS_API_KEY}}
Content-Type: application/json

{
  "model": "zai-org/GLM-5.3-Flash",
  "messages": [{ "role": "user", "content": "Hello" }]
}

Dikkat edilmesi gereken üç şey. Adres, CheapTokens API temel adresi https://api.cheaptokens.dev/v1 artı /chat/completions'tür. Model, tam kimliğiyle yazılmıştır: zai-org/GLM-5.3-Flash, yanıt başına 8.192 token'a kadar yazabilen 390K bağlamlı bir model. Ve anahtar yalnızca bir {{$dotenv …}} yer tutucusudur, bu nedenle bu dosyayı commit'lemek güvenlidir.

Kurulumunuz .env dosyasını almıyorsa, README ayrıca makinenizin ortamından bir değişken okuyan {{$processEnv NAME}} özelliğini de açıklar.

Gönderin ve yanıtı bulun#

İstek satırının üzerindeki "Send Request"e tıklayın veya Ctrl+Alt+R'ye (macOS'ta Cmd+Alt+R) basın. Sağ tıklayabilir veya F1'i de kullanabilirsiniz. Yanıt ayrı bir panelde açılır. Arama ve katlama yapabileceğiniz normal bir editör sekmesini tercih ediyorsanız, ayarlarda rest-client.previewResponseInUntitledDocument değerini true olarak ayarlayın.

Yanıt, standart sohbet tamamlama JSON'udur. İlk günde önemli olan iki yer:

• choices[0].message.content yanıt metnidir. Yanında, finish_reason modelin neden durduğunu söyler. length, yanıtın token sınırı nedeniyle kesildiği anlamına gelir.
• usage bu istek için token sayılarını tutar: gönderdiğiniz token'lar ve modelin yazdığı token'lar. Ödediğiniz şey budur, bu yüzden her seferinde ona bakın.

Para konusunda bir fikir edinmek için: bu isteği yaklaşık 1.000 token giriş ve 300 token çıkışla 100 kez gönderdiğinizi varsayalım (örnek için bir varsayım, ölçüm değil).

Tablo, bu iş yükünün her modeldeki canlı fiyatını, karşılaştırma için bir OpenRouter sütunuyla birlikte gösterir. Küçük bir "Merhaba" çok daha ucuza gelir.

Modeli tek satırda değiştirin#

Düz bir metin dosyasının kullanışlı yanı: bir satırı değiştirin ve yeniden gönderin. Model kimliğini deepseek-ai/DeepSeek-V4-Flash-0731 ile değiştirin (380K bağlam, yanıt başına 32.768 token'a kadar, günün her saatinde tek fiyat, giriş ve çıkış birlikte sayıldığında toplamda OpenRouter'dan daha ucuz) ve bir kez daha Ctrl+Alt+R'ye basın. Aynı gövde, aynı anahtar, farklı bir yanıt ve farklı bir usage.

İkisini de tutmak ister misiniz? Bir ### satırının altına diğer model kimliğiyle ikinci bir istek yapıştırın. Her istek kendi Send Request bağlantısını alır, böylece bunları arka arkaya çalıştırıp karşılaştırabilirsiniz. Bir kimlikten emin değil misiniz? GET /v1/models ile modelleri listeleyin tam dizeleri gösterir.

Çalışmazsa#

İlk ikisi için, API 401 veya 404: yanlış anahtar, temel URL veya model kimliği kontrolleri adım adım anlatır. Tam istek ayrıntıları CheapTokens belgelerinde, güncel fiyatlar ise fiyatlandırma sayfasında bulunur.

İş akışının tamamı bu: bir dosya, .env içinde bir anahtar, bir kısayol. Buradan bir sistem mesajı ekleyebilir, max_tokens değerini değiştirebilir veya aynı gövdeyi herhangi bir dilde koda dönüştürebilirsiniz.