APIMaster.ai
APIMaster.ai Belgeleri
Quick startAPIMaster.aiMarketplace

OpenCode ile APIMaster.ai

APIMaster'ı OpenCode Desktop'ta OpenAI uyumlu bir sağlayıcı olarak ekleyin, opencode.jsonc aracılığıyla isteğe bağlı Reasoning katmanlarıyla.

OpenCode Desktop, OpenCode (şu anda beta) için grafiksel istemcidir: yerel aracı oturumları, dosya düzenlemeleri ve kabuk yürütmeleri. APIMaster.ai, OpenAI ile uyumludur — Ayarlar → Sağlayıcılar → Özel sağlayıcı altına ekleyin.

Önce API Anahtarınızı alın. Aşağıda your_apimaster_key yer tutucusunu kullanın; ekran görüntüleri gerçek anahtarları maskeler.

Ön koşullar

  1. OpenCode Desktop, opencode.ai/download adresinden yüklenmiş olmalıdır.
    • Windows: opencode-desktop-win-x64.exe
    • macOS: brew install --cask opencode-desktop veya .dmg
    • Linux: .deb / .rpm / AppImage
  2. Konsoldan APIMaster API Anahtarı.

Adım 1 — Sağlayıcıları açın

  1. OpenCode Desktop'ı başlatın ve bir çalışma alanı açın.
  2. Dişli çark simgesine (sol alt köşe) tıklayın.
  3. Kenar çubuğunda Sağlayıcılar'ı seçin.
  4. Özel sağlayıcı bölümüne gidin (Temel URL ile OpenAI uyumlu bir sağlayıcı ekleyin).
  5. + Bağlan'a tıklayın.

Ayarlar → Sağlayıcılar → Özel sağlayıcı

Adım 2 — Özel sağlayıcı formu

Alan Değer
Sağlayıcı Kimliği apimaster
Görünen ad APIMaster.ai
Temel URL https://apimaster.ai/v1
API anahtarı APIMaster anahtarınız

Özel sağlayıcı formu

Başlıklar kısmını boş bırakın; yalnızca başlıklar üzerinden kimlik doğrulama yapmıyorsanız.

Adım 3 — Modelleri ekleyin ve Gönderin

Bir sonraki ekranda modelleri eşleyin (sol = OpenCode'daki etiket, sağ = APIMaster'a gönderilen model kimliği — genellikle aynıdır):

Sol Sağ
gpt-5.4 gpt-5.4
claude-sonnet-4-6 claude-sonnet-4-6
  1. Daha fazla satır için + Model ekle'ye tıklayın.
  2. Gönder'e tıklayın.

Modelleri ekleyin ve Gönderin

Kimlikleri marketten alın. Aracı sohbeti için yalnızca görsel modellerinden (ör. gpt-image-2) kaçının.

Adım 4 — Bir model seçin

  1. Bir oturum başlatın veya açın.
  2. Giriş alanının altındaki model açılır menüsünü açın.
  3. APIMaster.ai altında bir model seçin (ör. claude-sonnet-4-6).

Model seçici

Adım 5 — Test edin

Merhaba veya küçük bir kodlama görevi gönderin. Normal bir Asistan yanıtı (dosya düzenlemeleri / kabuk) APIMaster'ın bağlı olduğu anlamına gelir.

Sohbet testi

Gelişmiş: opencode.jsonc ve Reasoning

Yukarıdaki UI akışı hızlı bir başlangıç için yeterlidir. Aynı model kimliği için Reasoning / düşünme çabası katmanlarını (low, high, max, …) yapılandırmak için opencode.jsonc dosyasını düzenleyin.

Yapılandırma dosyası konumu

İşletim Sistemi Yol
macOS / Linux ~/.config/opencode/opencode.jsonc
Windows C:\Users\<kullanıcı_adı>\.config\opencode\opencode.jsonc

Dosya yoksa oluşturun. Kaydettikten sonra OpenCode Desktop'ı yeniden başlatın veya yeni bir oturum başlatın.

API Anahtarı (jsonc içine koymayın)

API Anahtarınızı opencode.jsonc içinde saklamayın.

Bunun yerine kullanın:

  • Terminalde /connect veya
  • Ayarlar → Sağlayıcılar → Sağlayıcıyı Bağla (yukarıdaki 1–2. adımlarla aynı).

Gizli bilgileri OpenCode'un kimlik doğrulama deposunda tutun; jsonc yalnızca sağlayıcıyı, modelleri ve Reasoning varyantlarını tanımlar.

APIMaster sağlayıcısı jsonc içinde

Sağlayıcı kimliği: apimaster. npm paketi: @ai-sdk/openai-compatible.

baseURL şöyle olmalıdır:

https://apimaster.ai/v1

Değil https://apimaster.ai/ — OpenCode sonuna /chat/completions ekler. /v1 olmadan https://apimaster.ai/chat/completions alırsınız → 404 Bulunamadı.

Reasoning varyantlarıyla tam örnek — indirin ve OpenCode'un yapılandırmasının üzerine yazın:

  1. opencode.jsonc dosyasını indirin
  2. Üzerine yazın (veya şuraya kaydedin):
    • macOS / Linux: ~/.config/opencode/opencode.jsonc
    • Windows: C:\Users\<kullanıcı_adı>\.config\opencode\opencode.jsonc
  3. API Anahtarını /connect veya UI aracılığıyla yapılandırın (asla jsonc içinde değil).
  4. OpenCode Desktop'ı yeniden başlatın veya yeni bir oturum başlatın.

Üzerine yazmadan önce mevcut dosyanızı yedekleyin veya yalnızca provider.apimaster bloğunu birleştirin.

Minimal şekil:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apimaster": {
      "name": "APIMaster.ai",
      "npm": "@ai-sdk/openai-compatible",
      "options": { "baseURL": "https://apimaster.ai/v1" },
      "models": {
        "gpt-5.4": {
          "name": "gpt-5.4",
          "variants": {
            "low": { "reasoningEffort": "low" },
            "high": { "reasoningEffort": "high" }
          }
        }
      }
    }
  }
}

Reasoning ilkeleri

  • variants = UI'da bir model kimliği için birden çok Reasoning katmanı.
  • OpenAI uyumlu API'ler için OpenCode, reasoningEffort → istek gövdesinde reasoning_effort olarak eşler.
  • Varyant adları gerçek parametreyle eşleşmelidir (high → "reasoningEffort": "high").
  • Her model farklı katmanları destekler — resmi belgelere göre yapılandırın; gizli yeniden eşleme yoktur.

Modele göre Reasoning katmanları

Model Reasoning varyantları Notlar
gpt-5.4 low, medium, high, xhigh GPT reasoning
gpt-5.5 low, medium, high, xhigh GPT reasoning
deepseek-v4-flash high, max DeepSeek düşünme (önerilen)
deepseek-v4-pro high, max DeepSeek düşünme (önerilen)
claude-sonnet-4-6 low, medium, high, max Claude Sonnet çaba
claude-opus-4-7 low, medium, high, xhigh, max Claude Opus çaba
claude-opus-4-8 low, medium, high, xhigh, max Claude Opus çaba
claude-haiku-4-5 yok Onaylanmamış çaba katmanı yok
minimax-m3 yok Onaylanmamış çaba katmanı yok

Tam dosya için opencode.jsonc dosyasına bakın.

OpenCode'da Reasoning değiştirme

  1. opencode.jsonc dosyasını kaydedin, ardından yeniden başlatın veya yeni oturum açın.
  2. Model / Reasoning açılır menüsünü kullanın (ör. gpt-5.4 / high).
  3. Yapınızda destekleniyorsa: Ctrl + Shift + D Reasoning katmanlarında gezinir.

Sorun giderme

UI kurulumu

Sorun Çözüm
401 Anahtarı kontrol edin; ifşa olduysa döndürün
Model bulunamadı Temel URL https://apimaster.ai/v1 olmalıdır; model kimliği marketle eşleşmelidir
APIMaster modelleri yok Ayarlar'da sağlayıcıyı düzenleyin → eşlemeler ekleyin → Gönder
Yavaş / zaman aşımı Başka bir model deneyin; API Anahtarı Test Aracı kullanın

Reasoning / jsonc

DeepSeek için neden yalnızca high ve max?
DeepSeek için resmi OpenAI uyumlu düşünme çabası high ve max'tır. Öngörülemeyen şekilde yeniden eşlenen low / medium / xhigh kullanmaktan kaçının.

Claude Sonnet için neden max, xhigh değil?
Sonnet'in en üst katmanı max'tır; xhigh Opus içindir (claude-opus-4-7 / claude-opus-4-8).

Haiku veya MiniMax M3 için neden varyant yok?
Belgelenmiş reasoningEffort değerleri olmadan varyantları atlayın — model yine de çalışır; UI yalnızca Reasoning alt katmanlarını göstermez.

Hala 400 alıyorum?

  1. baseURL = https://apimaster.ai/v1 (site kökü değil).
  2. Model kimliği yazımı marketle eşleşiyor.
  3. Anahtar /connect veya UI aracılığıyla yapılandırıldı.
  4. Geçici olarak variants kısmını kaldırın — düz istekler çalışıyorsa, seçilen reasoning_effort bu model için desteklenmiyor olabilir.

Güvenlik

  • Anahtarları asla sohbette veya redaksiyonsuz ekran görüntülerinde paylaşmayın.
  • Ekran görüntülerinde veya günlüklerde görünen anahtarları döndürün.
  • OpenCode dosyaları okuyabilir/yazabilir ve kabuk komutları çalıştırabilir — yalnızca güvenilir çalışma alanları kullanın.

Kontrol listesi

  • OpenCode Desktop yüklendi
  • Özel sağlayıcı bağlandı veya opencode.jsonc içinde apimaster
  • Temel URL / baseURL = https://apimaster.ai/v1 ( https://apimaster.ai/ değil)
  • API Anahtarı /connect veya UI aracılığıyla (jsonc içinde değil)
  • En az bir sohbet modeli eşlendi
  • (İsteğe bağlı) Reasoning varyantları resmi katmanlarla eşleşiyor
  • Test mesajı başarılı

Özet

  • Anahtarlar: baseURL (https://apimaster.ai/v1), model kimliği, API Anahtarı (/connect veya UI), isteğe bağlı Reasoning varyantları.
  • Varyant adları = gerçek reasoning_effort değerleri.
  • Katmanları modele göre yapılandırın; desteklenmiyorsa varyantları atlayın (Haiku, MiniMax M3).

Ayrıca bkz.