Ana sayfa / Rehberler / OpenCode'u ücretsiz LLM API ile kullanın

OpenCode'u ücretsiz LLM API ile kullanın

OpenCode, terminal ve masaüstü için açık kaynaklı bir kodlama agentıdır. Herhangi bir OpenAI uyumlu sağlayıcıyı kabul eder. Bu kılavuz OpenCode'u FreeLLMAPI üzerinden ücretsiz modellere bağlar. Tek bir komut yapılandırmayı yazar ve anahtarı saklar.

Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.

1. adım: FreeLLMAPI'yi kurun

FreeLLMAPI açık kaynaklı bir ağ geçididir. Docker içinde bilgisayarınızda çalışır ve 45 sağlayıcının ücretsiz katmanlarını tek bir anahtarın arkasında toplar.

macOS veya Linux'a kurun

curl -fsSL https://freellmapi.co/install.sh | bash

http://localhost:3001 adresini açın. Keys sayfasına en az iki ücretsiz sağlayıcı anahtarı ekleyin. Google AI Studio ve Groq, birkaç dakika içinde birer ücretsiz anahtar verir. Birleşik anahtarınızı aynı sayfadan kopyalayın.

2. adım: OpenCode'u tek komutla bağlayın

Tek komut

npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencode

Komut üç şey yapar:

  • Bir freellmapi sağlayıcısını ~/.config/opencode/opencode.json dosyasına ekler. Sağlayıcı, canlı kataloğunuzdaki modelleri bağlam limitleriyle listeler.
  • freellmapi/auto değerini varsayılan model olarak ayarlar.
  • Anahtarı OpenCode'un kimlik bilgisi dosyası olan ~/.local/share/opencode/auth.json dosyasında saklar. CLI'de veya masaüstü uygulamasında ortam değişkenine gerek yoktur.

Komut yazmadan önce bir yedek alır. Yeni sağlayıcıyı mevcut ayarlarla birleştirir, bu nedenle diğer sağlayıcılarınız kalır. XDG_CONFIG_HOME veya XDG_DATA_HOME ayarlıysa komut bu klasörleri kullanır.

Uzun bir göreve başlamadan önce ağ geçidinin şu anda bir isteğe yanıt verebildiğinden emin olun. Bu çağrı yalnızca o anda kullanılabilir anahtarı olan modelleri listeler:

Hangi modellerin hazır olduğunu kontrol edin

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

exhausted durumundaki bir model anahtarlara sahiptir, ancak hepsi şu anda limitindedir. Bu durum, bekleme süreleri bitince temizlenir. Bir istemcinin isteklerinin ağ geçidine ulaştığından emin olmak için npx freellmapi doctor komutunu çalıştırın. Kontrol panelindeki istek günlüğü, OpenCode'dan gelen her çağrıyı gösterir. X-Routed-Via yanıt üstbilgisi, her isteği yanıtlayan sağlayıcıyı ve modeli gösterir. Bir istek başka bir sağlayıcıya geçtiyse X-Fallback-Trail üstbilgisi, başarısız olan her adımı ve nedenini gösterir.

Elle kurulum: opencode.json sağlayıcı bloğu

Elle kurmak için bu bloğu ~/.config/opencode/opencode.json dosyasına veya projenizdeki opencode.json dosyasına ekleyin. OpenCode, @ai-sdk/openai-compatible paketini /v1/chat/completions uç noktaları için kullanır.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "freellmapi/auto",
  "provider": {
    "freellmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeLLMAPI",
      "options": {
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Sonra anahtarı ekleyin. OpenCode'u başlatın, /connect komutunu çalıştırın, freellmapi sağlayıcısını seçin ve birleşik anahtarınızı yapıştırın. /connect içindeki sağlayıcı kimliği, yapılandırmadaki kimlikle eşleşmelidir. Model seçmek için /models komutunu çalıştırın.

  • limit.context, modelin en fazla girdi token sayısıdır. limit.output, modelin üretebileceği en fazla token sayısıdır.
  • Üst düzey model alanı provider/model biçimini kullanır. Bu alan yoksa OpenCode, daha önce kullandığı modeli korur.
  • Kullanmak istediğiniz her model kimliği models eşleşmesinde olmalıdır. GET /v1/models üzerinden daha fazla kimlik ekleyin.
Yapılandırma sürümleri hakkında not: OpenCode belgeleri artık providers anahtarı içeren bir V2 yapılandırma biçimini tanımlar. Belgeler, yukarıdaki V1 biçiminin desteklenmeye devam ettiğini söyler. FreeLLMAPI kurulum komutu V1 biçimini yazar.

OpenCode için modeller seçin

OpenCode bir agenttır. Araç çağrıları yoluyla dosyaları okur, düzenler ve komutları çalıştırır. Her istek bir sistem istemi, araç tanımları ve dosya içerikleri taşır. Araç çağrısı olan ve geniş bir bağlam penceresi bulunan modelleri kullanın.

OpenCode için ücretsiz modeller: araç çağrısı ve 128K+ bağlam
ModelÜcretsiz olduğu yerBağlamÜcretsiz limitler (en iyi teklif)AraçlarGörsel girdi
GLM 5.3UnoRouter1M1 istek/dk
1 req/min per model
EvetHayır
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 istek/dk
40 RPM
EvetEvet
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaEvetEvet
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceEvetHayır
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditEvetEvet
Gemini 3.7 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditEvetEvet
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 istek/dk
50 istek/gün
50 req/day account-wide (1,000 after a $10 purchase)
EvetEvet
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 istek/dk
50 istek/gün
Shared rate limit
EvetHayır
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 istek/dk
250 istek/gün
70,000 jeton/dk
~6M
EvetEvet
Gemini 3.6 FlashGoogle AI Studio1M10 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayEvetEvet

109 eşleşen ücretsiz modelden 12 tanesi gösteriliyor. Tüm modelleri gör.

Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.

Her istek için yönlendiricinin bir model seçmesi üzere freellmapi/auto kullanın. İstekleri zekâya veya hıza göre yönlendirmek için auto:smart veya auto:fast değerini models eşleşmesine ekleyin. Kontrol panelinde oluşturduktan sonra, örneğin auto:coding gibi adlandırılmış bir profil de ekleyebilirsiniz.

Hız limitleri ve uzun oturumlar

Tek bir agent görevi düzinelerce istek gönderebilir. Tek bir ücretsiz katman uzun bir görevi hızla durdurur. FreeLLMAPI her anahtarın istek ve token sayısını sayar. Bir sağlayıcı 429 hatası gönderdiğinde yönlendirici isteği zincirdeki sonraki modele gönderir ve oturum devam eder.

  • Dört veya daha fazla sağlayıcıdan anahtar ekleyin. Daha fazla sağlayıcı, günde daha fazla istek verir.
  • FREELLMAPI_CONTEXT_HANDOFF=on_model_switch değerini FreeLLMAPI .env dosyasında ayarlayarak bağlam devrini açın. Model değiştiğinde, sonraki model bir görevi sürdürdüğüne dair kısa bir not alır.
  • Yapışkan oturumlar, bir konuşmayı 30 dakika boyunca tek bir modelde tutar. Bu, agentın tutarlı kalmasını sağlar.
  • Her görev için yeni bir oturum başlatın. Daha küçük bir bağlam, istek başına daha az token kullanır.

Sorun giderme

SorunNedenÇözüm
Geçerli bir anahtarla "Invalid API key"Yapılandırmadaki boş apiKey, /connect anahtarının yerine geçerapiKey alanını options bölümünden kaldırın veya setup-opencode komutunu yeniden çalıştırın
OpenCode yeni sağlayıcıyı kullanmıyorÜst düzey model ayarlanmamış"model": "freellmapi/auto" olarak ayarlayın
Model bulunamadıModel kimliği sağlayıcının models eşleşmesinde yokKimliği eşleşmeye ekleyin veya setup-opencode komutunu yeniden çalıştırın
{env:VAR} anahtarı boşOpenCode, ayarlanmamış bir değişkeni boş bir metinle değiştirirDeğişkeni aynı kabukta dışa aktarın veya anahtarı /connect ile saklayın
Araç çağrıları başarısız oluyorModel zayıf araç çağrısı yapıyorYukarıdaki tablodan bir model seçin
"Tüm modeller N denemeden sonra hız limitine takıldı"Tüm anahtarlar limitindeDaha fazla sağlayıcıdan anahtar ekleyin veya bekleme sürelerinin dolmasını bekleyin
Bunların hepsini tek bir anahtarla kullanın. FreeLLMAPI, açık kaynaklı ve kendi sunucunuzda çalışan bir yönlendiricidir. Tüm bu ücretsiz katmanları tek bir OpenAI uyumlu uç noktanın arkasında toplar ve bir sağlayıcı hız limitine takıldığında otomatik olarak başka birine geçer. Kataloğa göz atın veya canlı olarak incele.

Sık sorulan sorular

OpenCode'u ücretsiz kullanabilir miyim?

Evet. OpenCode açık kaynaklıdır. FreeLLMAPI'ye OpenAI uyumlu bir sağlayıcı olarak bağlayın. Ağ geçidi her isteği ücretsiz sağlayıcı katmanlarına gönderir, bu nedenle çıkarım maliyeti $0'dır.

OpenCode'a özel bir OpenAI uyumlu sağlayıcı nasıl eklenir?

opencode.json dosyasına npm değeri @ai-sdk/openai-compatible olan, options.baseURL ve bir models eşleşmesi içeren bir sağlayıcı ekleyin. Sonra anahtarı saklamak için /connect, model seçmek için /models komutunu çalıştırın.

OpenCode için en iyi ücretsiz model hangisi?

En az 128K bağlamı olan ve araç çağrısı yapan bir model kullanın. Bu sayfadaki tablo, bugün her iki kuralı da karşılayan en güçlü ücretsiz modelleri gösterir. Yönlendiricinin birini seçmesi için freellmapi/auto kullanın.

OpenCode API anahtarlarını nerede saklar?

/connect ile eklenen anahtarlar ~/.local/share/opencode/auth.json dosyasına gider. FreeLLMAPI kurulum komutu anahtarı oraya yazar, bu nedenle hem CLI hem de masaüstü uygulaması onu bulur.

İlgili rehberler

Kaynaklar

Tüm rehberler · Tüm ücretsiz modelleri incele