OpenCode'u CheapTokens'a nasıl bağlarsınız (opencode.json)

OpenCode'u CheapTokens'a bağlamak için özel bir OpenAI uyumlu sağlayıcı ekleyin: API anahtarınızı /connect ile saklayın (sağlayıcı kimliği cheaptokens), ardından sağlayıcıyı opencode.json içinde temel URL https://api.cheaptokens.dev/v1 ile tanımlayın. Bundan sonra CheapTokens modelleriniz /models içinde görünür.

Bu kılavuz OpenCode sağlayıcı belgelerini takip eder (sayfa 20 Ekim 2026'da güncellendi; 22 Ekim 2026'da kontrol edildi). Aynı yaklaşım bu serideki diğer araçlar için de geçerlidir: Cline, Aider ve Kilo Code.

İhtiyacınız olanlar#

• OpenCode kurulu olmalı (platformunuz için belgelerine bakın).
• Bir CheapTokens API anahtarı. Hesabınızda bir tane oluşturun ve bakiyeyi yükleyin; tek bakiye tüm modelleri kapsar. Temel bilgiler CheapTokens belgelerinde.
• API bilgileri:
  • temel URL: https://api.cheaptokens.dev/v1
  • uyumluluk: OpenAI Chat Completions ve Anthropic Messages
  • aşağıda kullanılan model kimliği: deepseek-ai/DeepSeek-V4-Flash-0731 (380K bağlam, 32.768'e kadar çıktı token'ı). Model kimlikleri CheapTokens belgelerinde listelenmiştir: adlar sağlayıcılar arasında farklılık gösterir, bu yüzden kimliği oradan kopyalayın.

Adım 1. Anahtarı /connect ile saklayın#

1. Projenizde OpenCode'u başlatın ve /connect komutunu çalıştırın.
2. Other seçeneğine kaydırın.
3. Benzersiz bir sağlayıcı kimliği girin: cheaptokens.
4. CheapTokens API anahtarınızı yapıştırın.

Bu adım yalnızca kimlik bilgisini saklar. OpenCode hâlâ sağlayıcının adresini veya modellerini bilmez: bunun için opencode.json gereklidir.

Adım 2. Sağlayıcıyı opencode.json içinde tanımlayın#

opencode.json dosyasını oluşturun veya düzenleyin ve sağlayıcıyı ekleyin. provider içindeki sağlayıcı kimliği, /connect içinde girdiğiniz kimlikle eşleşmelidir.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

Her bölümün işlevi:

• npm — @ai-sdk/openai-compatible, /v1/chat/completions kullanan uç noktalar için pakettir ve CheapTokens da bunu sunar. (OpenCode, /v1/responses üzerine kurulu uç noktalar için @ai-sdk/openai kullanır.)
• name — OpenCode arayüzünde gösterilen etiket.
• options.baseURL — CheapTokens API adresi.
• models — model kimliğine göre anahtarlanır; içindeki name bir görünen addır.
• limit.context / limit.output — isteğe bağlı; OpenCode'a modelin bağlam penceresini ve maksimum yanıt uzunluğunu bildirir.

Anahtarı bunun yerine bir ortam değişkeninde saklayın (isteğe bağlı)#

Anahtarı OpenCode'un kimlik bilgisi deposunda tutmak istemiyorsanız, belgelerin önerdiği {env:VARIABLE} sözdizimiyle options dosyasına apiKey ekleyin:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Ardından kabuğunuzda CHEAPTOKENS_API_KEY dışa aktarın. Depoya gerçek bir anahtar işlemeyin. Anahtarlarda yeniyseniz, API anahtarı nedir ve güvenle nasıl saklanır yazısını okuyun.

Adım 3. Çalıştığını kontrol edin#

/models komutunu çalıştırın ve CheapTokens sağlayıcısı altında DeepSeek-V4-Flash'i seçin. Ardından kısa bir istem gönderin, örneğin: "Bu deponun ne yaptığını üç cümleyle özetle." Normal bir yanıt, temel URL, anahtar ve model kimliğinin hepsinin doğru olduğu anlamına gelir.

Hangi CheapTokens modelini seçmeli#

models içine istediğiniz kadar girdi ekleyin — her biri yukarıdakine benzer, kendi kimliğine sahip bir bloktur.

Döngü içinde çok sayıda istek gönderen bir OpenCode oturumu için DeepSeek-V4-Flash iyi bir varsayılandır: çıktı OpenRouter'ın referans fiyatından daha ucuzdur, yanıtlar 32.768 token'a ulaşabilir ve fiyatın yoğun saatleri yoktur. MiniMax-M2.7 de hem girdide hem çıktıda OpenRouter'ın referans fiyatlarından daha ucuzdur. GLM-5.3-Flash'in çıktısı da OpenRouter'ın referans fiyatından daha ucuzdur. Güncel fiyatlar (canlı kontrol edildi, eskimeyecek sayı yok):

Bir çalışma oturumunu tahmin etmek için, örneğin her biri 100.000 girdi ve 5.000 çıktı token'lı 20 istek:

Daha fazlası için tüm fiyatlara ve DeepSeek sayfasına bakın.

Çalışmazsa#

• /models içinde sağlayıcı veya modeller eksik. opencode.json dosyasının geçerli JSON olduğunu (sonda virgül yok) ve provider altındaki anahtarın /connect içinde girdiğiniz kimlikle tam olarak aynı olduğunu kontrol edin. İkisi de doğruysa OpenCode'u yeniden başlatın.
• 401 / kimlik doğrulama hatası. /connect komutunu yeniden çalıştırıp anahtarı tekrar yapıştırın veya OpenCode'un başlatıldığı kabuktaki CHEAPTOKENS_API_KEY değişkenini kontrol edin.
• 404 veya "model not found". models içindeki model kimliği, satıcı öneki (deepseek-ai/…) dahil olmak üzere CheapTokens kimliğiyle karakter karakter eşleşmelidir.
• Bağlantı hataları. Temel URL /v1 ile bitmeli ve ekstra yol içermemelidir. Yaygın bağlantı hatalarına bakın.
• "Not enough tokens". Bakiyeyi yükleyin; hatanın ne anlama geldiğine bakın.

Sonraki adımlar#

Artık OpenCode, tüm modeller için tek bakiyeyle CheapTokens üzerinde çalışıyor. CheapTokens belgelerinden bir anahtar alın ve ilk çağrınızı yapın.