Hoppscotch'ta CheapTokens'a ilk istek: anahtar bir ortamda

İlk CheapTokens isteğinizi Hoppscotch'ta hiçbir şey kurmadan veya kod yazmadan yapabilirsiniz: web uygulamasını açın, temel URL'yi ve anahtarınızı bir ortama koyun, tek bir POST /chat/completions isteği oluşturun, Gönder'e basın. Yanıt ve token sayıları yanıt panelinde görünür.

Dikkatli yapmaya değer tek şey anahtardır. Doğrudan isteğe yapıştırırsanız, her ekran görüntüsüne ve paylaşılan her bağlantıya girer. Bir ortam değişkeni onu tek bir yerde tutar.

Bu kılavuz resmi Hoppscotch belgelerini izler (9 Kasım 2026'da kontrol edildi; sayfalarda sürüm veya tarih yok). API tarafı, OpenAI Chat Completions formatını konuşan CheapTokens temel URL'si https://api.cheaptokens.dev/v1'dir. Her ikisi hakkında daha fazlası CheapTokens belgelerinde.

Temel URL'yi ve anahtarı bir ortama koyun#

Hoppscotch'un kenar çubuğunda bir Ortamlar simgesi vardır. Tıklayın, yeni bir ortam oluşturun, adını cheaptokens koyun ve iki değişken ekleyin:

Neden iki tür? Hoppscotch belgelerine göre, Normal bir değişken ortamı görebilen herkese görünür, Gizli olan ise maskelenir, asla senkronize edilmez veya paylaşılmaz ve dışa aktarmalardan ve kopyalardan çıkarılır. Bir anahtar ikinci türe aittir: değişkenin değeri olarak girin. Ardından isteğin görebilmesi için cheaptokens ortamını seçin.

İsteklerde bir değişken <<name>> olarak yazılır: <<baseURL>> ve <<api_key>>. Bütün hile bu.

İsteği oluşturun#

Hoppscotch'u açtığınızda REST etkin moddur. Ayarlanacak üç şey var.

Yöntem ve URL. Açılır menüden POST seçin ve girin:

<<baseURL>>/chat/completions

Anahtar. Hoppscotch'un Yetkilendirme sekmesinde Bearer türü vardır ve token'ı isteğe Bearer <token> olarak ekler. Belgeler <<api_key>>'nin o token alanında çalışıp çalışmadığını söylemez, bu yüzden kesin yolu kullanın: Başlıklar sekmesini açın ve bir başlık ekleyin.

Authorization: Bearer <<api_key>>

Değişkeni hiçbir yerde elle değiştirmezsiniz ve gerçek anahtar ekranda gördüğünüz istekte asla görünmez.

Gövde. Gövde sekmesini açın, İçerik Türü açılır menüsünden application/json seçin (belgeler bunu JSON formatındaki içerik türü olarak listeler) ve yapıştırın:

{
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "messages": [
    {"role": "user", "content": "Explain what a token is in one sentence."}
  ],
  "max_tokens": 200
}

Tam kimliği deepseek-ai/DeepSeek-V4-Flash-0731 kullanın. Bir fiyat listesindeki kısa ad API tarafından kabul edilmez. DeepSeek-V4-Flash 380K bağlam ve yanıt başına en fazla 32.768 çıktı token'ına sahiptir, bu yüzden 200 bir test için kasıtlı olarak küçük bir üst sınırdır. Farklı bir model mi istiyorsunuz? O tek alanı zai-org/GLM-5.3-Flash olarak değiştirin (390K bağlam, en fazla 8.192 çıktı token'ı) ve tekrar gönderin.

Gönder'e basın ve yanıtı okuyun#

Gönder'e tıklayın. Yanıt bölümü durum kodunu, gövdeyi, başlıkları, çerezleri ve zamanlamayı gösterir. İstediğiniz 200 ve OpenAI sohbet tamamlama formatına benzeyen bir JSON gövdesidir. İki yer önemlidir:

• choices[0].message.content modelin yanıtıdır.
• usage içinde prompt_tokens (gönderdiğiniz) ve completion_tokens (modelin yazdığı) vardır. Faturalandırıldığınız şey budur, bu yüzden bir isteğin beklediğiniz maliyette olduğunu burada kontrol edersiniz.

Ayrıca choices[0].finish_reason'ye bakın. stop modelin kendi kendine bitirdiği anlamına gelir. length, max_tokens sınırınızın yanıtı kestiği anlamına gelir. Tek cümlelik bir soruda bunu görüyorsanız, sınır çok düşüktür. Daha uzun bir açıklama AI yanıtı kesildi mi? finish_reason "length" sorununu düzeltin sayfasında.

İsteği bir koleksiyona kaydedin ve yeniden kullanılabilir hale gelir: mesajı değiştirin, tekrar Gönder'e basın.

Bir test isteğinin maliyeti#

Kısa bir soru ve kısa bir yanıt alın: diyelim 30 token giriş ve 150 çıkış. Böyle bir istek $0.000015 maliyetindedir ve aşağıdaki canlı tablo, giriş ve çıkışı birlikte sayarak bunlardan 100 tanesini OpenRouter'ın yanında sayar.

Toplamda, giriş ve çıkış birlikte sayıldığında, aynı model için OpenRouter'dan daha ucuz. Kendi sayılarınız farklı olacaktır, bu yüzden kendi durumunuzda kaydırıcıları sürükleyin:

Fiyatlar model başına sabittir, yoğun saat fiyatlandırması yoktur ve tek bir bakiye tüm modelleri kapsar. Güncel ücretler fiyatlandırma sayfasında.

Çalışmazsa#

Bir REST istemcisinde ilk istek hatalarının çoğu üç alandan kaynaklanır. Belirtiyi nedene eşleştirin:

İlk ikisi için API 401 veya 404 hatası: yanlış anahtar, temel URL veya model kimliği sayfasında tam bir adım adım anlatım var. Hangi kimliği kullanacağınızdan emin değilseniz, GET /v1/models ile modelleri listeleyin.

Sırada ne var#

Aynı istek diğer istemcilerde de çalışır: Postman sürümüne veya VS Code .http dosyasına bakın. Anahtarları dosyalardan ve kabuklardan tamamen uzak tutmayı tercih ediyorsanız, bir API anahtarını güvenle saklayın temelleri kapsar. Model kimlikleri ve OpenAI uyumlu uç nokta belgelerde açıklanmıştır.