Bloga dön

Araçlar ve entegrasyonlarKılavuz

OpenHands'i CheapTokens'e bağlayın: model, Temel URL, anahtar

Ajanı bir CheapTokens modelinde çalıştırmak için OpenHands Ayarlar > LLM (Gelişmiş) bölümündeki üç alanı doldurun ve üç yaygın hatayı okumayı öğrenin.

Yazan: CheapTokens TeamYayınlanma tarihi: 3 dk okuma

CheapTokens Temel URL'si ve model kimliği ile OpenHands ayar alanları
Bu sayfada
  1. Ayarlar'ı açmadan önce
  2. Üç alan
  3. Önce parçaları OpenHands dışında kontrol edin
  4. Yanlış bir alan nasıl görünür
  5. Bir oturumun maliyeti
  6. OpenHands'i başka bir sağlayıcıyla zaten kullanıyor musunuz?

CheapTokens modelini kullanmak için OpenHands'te Ayarlar > LLM bölümüne gidip Gelişmiş seçeneğini açtıktan sonra üç alanı doldurmanız yeterli: Özel Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Temel URL (https://api.cheaptokens.dev/v1) ve API Anahtarı. Kurulumun tamamı bu kadar. Bu sayfanın geri kalanı, her alanın ne anlama geldiğini ve biri yanlış olduğunda bunun nasıl göründüğünü anlatıyor.

Alan adları ve model dizesi kuralı, OpenHands belgelerinin OpenAI uyumlu uç noktalar sayfasından alınmıştır (8 Kasım 2026'da kontrol edildi; sayfada tarih veya sürüm yok). O tarihteki en son OpenHands sürümü v1.37.0'dır (6 Kasım 2026). Sizin sürümünüzde bir etiket biraz farklı görünüyorsa konuma göre ilerleyin: model, temel URL, anahtar.

Ayarlar'ı açmadan önce#

El altında üç şey bulundurmak bir turu kurtarır: anahtar, model kimliği ve Ayarlar'a erişim.

Kontrol listesi

Yapılandırmaya hazır mısınız?

Anahtarlar ve temel URL'lerde yeni misiniz? base_url nedir ve nasıl değiştirilir birkaç dakikada anlatıyor, GET /v1/models ile modelleri listeleme ise bir kimliği kendiniz nasıl bulacağınızı gösteriyor.

Üç alan#

Ayarlar > LLM bölümünü açın ve Gelişmiş seçeneğini etkinleştirin. Temel URL alanı Gelişmiş anahtarının altında yer alır.

OpenHands Ayarlar > LLM (Gelişmiş) için üç değer
Değerlerin diyagramı, ekran görüntüsü değil: üç alanın her birine ne girileceği. Anahtar bir yer tutucudur.

Belgeler model kuralını şöyle açıklıyor: Özel Model, openai/ ardından model adıdır ve kendi öneki olan bir proxy üzerinden gidiyorsanız openai/<proxy-prefix>/<model-name>. openai/ sonrasındaki kısım model adıdır. CheapTokens için kimlik deepseek-ai/DeepSeek-V4-Flash-0731, dolayısıyla tam dize openai/deepseek-ai/DeepSeek-V4-Flash-0731.

Alan Değer
Özel Model openai/deepseek-ai/DeepSeek-V4-Flash-0731
Temel URL https://api.cheaptokens.dev/v1
API Anahtarı CheapTokens anahtarınız

Bir ajan için neden bu model? DeepSeek-V4-Flash 380K bağlam penceresine ve yanıt başına 32.768'e kadar çıktı tokenına sahiptir ve her saatte tek fiyat sunar, böylece uzun bir oturum yoğun saatlerde pahalanmaz. Bir kodlama ajanı her adımda çok fazla bağlamı yeniden gönderir ve pencere tam da bunun içindir.

GLM mi tercih edersiniz? Aynı alanda openai/zai-org/GLM-5.3-Flash kullanın (390K bağlam, 8.192'ye kadar çıktı tokenı) ve başka hiçbir şeyi değiştirmeyin. Aynı bakiye, aynı anahtar, aynı Temel URL.

Önce parçaları OpenHands dışında kontrol edin#

Ajanı suçlamadan önce aynı URL, anahtar ve kimlikle bir istek gönderin. Bu çalışıyorsa geriye kalan herhangi bir sorun alanları nasıl yazdığınızdadır.

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'

Eksik olana dikkat edin: model değerinde openai/ yok. Bu önek OpenHands içindir, API için değil. Yanıt, prompt_tokens ve completion_tokens içeren bir usage bloğu taşır — daha sonra bir ajan oturumu boyunca toplanırken göreceğiniz aynı iki sayı.

Karşılaştır

Model dizesi: bir önek, iki sonuç

Yalnızca kimlik

deepseek-ai/DeepSeek-V4-Flash-0731 — curl ve API için biçim.

Önek ile

openai/deepseek-ai/DeepSeek-V4-Flash-0731 — Özel Model alanı için biçim.

Yanlış bir alan nasıl görünür#

Üç alanın her biri neden olabilir:

Her hatanın işaret ettiği yer: anahtar, Temel URL, model dizesi
Belirtiden alana: 401 anahtara, 404 Temel URL'ye veya model dizesine işaret eder.
  • Yanlış anahtar. API 401 yanıtı verir — anahtar eksik, yanlış yazılmış veya kopyalarken sonunda boşluk kalmış.
  • Yanlış Temel URL. İstek yanlış yere gider ve 404 veya bağlantı hatası alırsınız. Adres /v1 ile bitmeli ve ekstra yol içermemelidir.
  • Yanlış model dizesi. Ya önek eksiktir ya da sonrasındaki kimlik tam kimlik değildir (API yalnızca tam gateway_id kabul eder, deepseek-v4-flash-0731 gibi kısa bir kimliği değil).

401 ile 404 arasındaki tam gerekçe API 401 veya 404: yanlış anahtar, temel URL veya model kimliği sayfasındadır.

Kendin deneDeneyin: anahtar doğru, URL doğru, ajan yine de ilk adımda başarısız oluyor. Hangi alanı açarsınız?Cevabı göster

Özel Model alanını. openai/ ile başladığını ve sonrasındaki kimliğin yukarıdaki tabloda olduğu gibi tam yazıldığını kontrol edin. Anahtar ve URL, curl ile doğrulanması kolay olanlardır.

Bir oturumun maliyeti#

Bir ajan her adımda tüm bağlam için faturalandırır, tek satırlık göreviniz için değil. Diyelim ki OpenHands bir hatayı 40 adımda çözüyor, her adımda yaklaşık 30.000 token gönderiliyor ve 1.500 token geri yazılıyor. DeepSeek-V4-Flash'te bir adım $0.0006; kırk adım aşağıda, diğer modeller ve OpenRouter'ın yanında.

Model İstek başına 40 istek OpenRouter, 40 istek
GLM-5.3-Flash $0.00066 $0.0264 $0.0452
DeepSeek-V4-Flash $0.0006 $0.024 $0.0924
MiniMax-M2.7 $0.0017 $0.069 $0.828

İstek başına 30.000 giriş ve 1.500 çıkış token'ı. 1M token başına fiyatlar günceldir ve tarifelerimizle birlikte değişir; OpenRouter sütunu aynı iş yükü için referans fiyatları gösterir.

Toplamda, girdi ve çıktı birlikte sayıldığında DeepSeek-V4-Flash bu iş yükü için OpenRouter'dan daha ucuza geliyor. Varsayımlar sizin değiştirebileceğiniz şeyler: kısa bir düzeltme 10 adım sürebilir, büyük bir yeniden düzenleme 100. Güncel fiyatlar fiyatlandırma sayfasında, model sayfası ise ucuz DeepSeek.

OpenHands'i başka bir sağlayıcıyla zaten kullanıyor musunuz?#

O zaman yalnızca üç değeri değiştirirsiniz: Özel Model, Temel URL, API Anahtarı. Projede başka hiçbir şey değişmez ve aynı şekilde geri dönebilirsiniz. API'nin kendisi için adım adım bağlantı CheapTokens belgelerinde; farklı bir araçta benzer bir kurulum ise Aider'ı bağla.

Etiketler: