BroadRouter
Başlayın

BroadNet Inference'ı opencode'a özel sağlayıcı olarak ekleyin

Güncellendi

opencode.jsonc içinde providers altına bir broadnet girdisi ekleyin: package @opencode/ai/providers/openai-compatible, settings.baseURL https://inference.broadnet.ai/v1 ve env BROADNET_API_KEY. Kısa model anahtarlarını modelID ile broadnet/glm-5.3 gibi BroadNet kimliklerine eşleyin, ardından modeli /models ile seçin. npm @ai-sdk/openai-compatible ve options.baseURL kullanan eski V1 yapılandırmaları da çalışmaya devam eder.

opencode, terminal için açık kaynaklı bir kodlama ajanıdır. Yerleşik kataloğunda olmayan sağlayıcılar opencode.jsonc içinde özel sağlayıcı (custom provider) olarak eklenir. BroadNet Inference OpenAI chat completions formatını konuştuğu için opencode’un OpenAI uyumlu çalışma zamanı paketini kullanır. Bu rehber güncel (V2) opencode belgelerini izler.

Kurulum

  1. Anahtarınızı opencode’u başlatan kabukta dışa aktarın:
export BROADNET_API_KEY='your-broadnet-key'
  1. Yapılandırmayı oluşturun. Projenize opencode.jsonc olarak koyun ya da her yerde kullanmak için ~/.config/opencode/opencode.jsonc dosyasına yazın.
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
  1. opencode’u başlatın ve modeli /models ile seçin. Referans broadnet/<eşleme anahtarı> biçimindedir, örneğin broadnet/glm-5.3. opencode BroadNet’e modelID değerini gönderir.

Yapılandırma dosyaları birleştirilir. opencode önce genel dosyayı, ardından geçerli dizinden yukarı doğru bulunan proje dosyalarını (en uzaktaki önce), sonra varsa .opencode/ yapılandırmasını uygular; böylece bir proje dosyası genel sağlayıcıyı geçersiz kılabilir. Şirketiniz kullanıyorsa yönetilen sistem yapılandırması ikisini de geçersiz kılar. Yapılandırmanın sürüm kontrolüne girebilmesi için anahtarı dosyada değil ortam değişkeninde tutun.

Neden takma adlar

BroadNet kimlikleri zaten bir eğik çizgi içerir (broadnet/glm-5.3). models eşlemesindeki anahtar opencode’un gösterdiği ve seçtiği addır; modelID ise gönderdiği değerdir. Kısa anahtarlar referansları okunur tutar.

capabilities ve limit değerlerini kendiniz ayarlayın. Kataloğu dışındaki bir model için opencode JSON araç desteği, metin ve görsel girdi, 200.000 token’lık bağlam ve 32.000 çıktı token’ı varsayar. Belgeleri bunlara algılanmış değerler değil, yedek varsayımlar (fallback) der. Yukarıdaki 16000 output değeri bir BroadNet sınırı değil, bizim önerimizdir; akıl yürütmeye yer bırakır.

Eski V1 yapılandırmaları

opencode V2 V1 formatını hâlâ okur, bu yüzden aşağıdaki gibi mevcut bir blok çalışmaya devam eder:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}

Yerel V2 biçiminde provider, providers olur; npm, package olur (AI SDK paketini korumak istiyorsanız aisdk:@ai-sdk/openai-compatible); options.baseURL ve options.apiKey de settings altına taşınır. opencode V1 geçiş rehberi her alanın karşılığını gösterir.

Hangi modeli seçmeli

Görev Model Notlar
Araçlarla ajan tabanlı kodlama GLM 5.3 Araçlar ve yapılandırılmış çıktı listeleniyor; 1M bağlam
Ekran görüntüleri, Arapça Qwen3.8 27B Araçlar ve görseller; 262K bağlam
Gün boyu oturumlar, sabit fiyat DeepSeek V4.1 Flash Sınırsız planlar; araçlar BroadNet tarafından listelenmiyor

opencode araç çağrılarına dayanır. BroadNet’in belgeleri DeepSeek V4.1 Flash için araç çağırmayı listelemez; bu yüzden yapılandırma bunu test edilmesi gereken bir varsayım olarak işaretler. Bir Full Moon ayı ($60) satın almadan önce gerçek bir işi bir Meteor saatinde ($1) deneyin.

Sorun giderme

  • 401. BROADNET_API_KEY içindeki anahtar yanlış, süresi dolmuş veya kullandıkça öde hakkı tükenmiş. Değişkenin opencode’u çalıştıran süreçte tanımlı olduğundan emin olun.
  • Model bulunamadı veya reddedildi. Eşleme anahtarını (broadnet/glm-5.3) seçin ve modelID değerinin BroadNet’in kimliğiyle birebir aynı olduğunu kontrol edin. Referanslar büyük-küçük harfe duyarlıdır. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızca broadnet/gemma-4-26b-a4b modelini kapsar.
  • Boş yanıtlar. limit.output değerini yükseltin. Yanıtlar neden boş geliyor.
  • 429. Kullandıkça öde anahtarları dakikada 30 isteğe ve aynı anda işlemde 4 isteğe izin verir. Yeniden denemeler de sayılır. Hatalar ve yeniden denemeler rehberine bakın.
  • Bir planda alt ajanlar. Her plan oturumu aynı anda tek istek işler; bu yüzden her birinin kendi oturumu yoksa paralel alt ajanlar sıraya girer.

Sık sorulan sorular

opencode BroadNet modelimi neden bulamıyor?

opencode referansı sağlayıcı/eşleme anahtarı olarak çözer ve kimlikler büyük-küçük harfe duyarlıdır. Aşağıdaki yapılandırmayla broadnet/glm-5.3 seçin; burada glm-5.3 eşleme anahtarıdır. modelID değeri yalnızca BroadNet'e gönderilen kimliktir.

Yapılandırmam @ai-sdk/openai-compatible ile provider ve npm kullanıyor. Bu yanlış mı?

Hayır. Bu V1 formatıdır ve opencode'un geçiş rehberine göre desteklenmeye devam ediyor. Yerel V2 biçiminde provider, providers olur; npm, package olur (aisdk:@ai-sdk/openai-compatible); options.baseURL de settings.baseURL olur.

opencode yanıtları neden boş geliyor?

Model çıktı bütçesini akıl yürütmeye harcamış. Modelin limit.output değerini yükseltin. BroadNet'te akıl yürütme max_tokens sınırına dahildir.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor