Beranda / Panduan / Gunakan OpenCode dengan free LLM API

Gunakan OpenCode dengan free LLM API

OpenCode adalah agent coding open source untuk terminal dan desktop. Aplikasi ini menerima penyedia apa pun yang kompatibel dengan OpenAI. Panduan ini menghubungkan OpenCode ke model gratis melalui FreeLLMAPI. Satu perintah menulis konfigurasi dan menyimpan kuncinya.

Kode, nama model, dan label katalog langsung ditampilkan dalam bahasa Inggris.

Langkah 1: Pasang FreeLLMAPI

FreeLLMAPI adalah gateway open source. Gateway ini berjalan di komputer Anda melalui Docker dan menggabungkan tier gratis dari 45 penyedia di balik satu kunci.

Pasang di macOS atau Linux

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

Buka http://localhost:3001. Tambahkan minimal dua kunci penyedia gratis di halaman Keys. Google AI Studio dan Groq masing-masing memberikan kunci gratis dalam beberapa menit. Salin kunci terpadu Anda dari halaman yang sama.

Langkah 2: Hubungkan OpenCode dengan satu perintah

Satu perintah

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

Perintah ini melakukan tiga hal:

  • Perintah menambahkan penyedia freellmapi ke ~/.config/opencode/opencode.json. Penyedia ini mencantumkan model dari katalog Anda saat ini beserta batas konteksnya.
  • Perintah mengatur freellmapi/auto sebagai model default.
  • Perintah menyimpan kunci di file kredensial OpenCode, ~/.local/share/opencode/auth.json. Anda tidak memerlukan variabel lingkungan, baik di CLI maupun di aplikasi desktop.

Perintah membuat cadangan sebelum menulis. Perintah menggabungkan penyedia baru, sehingga penyedia Anda yang lain tetap ada. Jika XDG_CONFIG_HOME atau XDG_DATA_HOME diatur, perintah menggunakan folder tersebut.

Sebelum Anda memulai tugas panjang, pastikan gateway dapat melayani permintaan sekarang. Panggilan ini hanya mencantumkan model yang memiliki kunci yang dapat digunakan saat ini:

Periksa model yang siap

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

Model dengan status exhausted memiliki kunci, tetapi semuanya sudah mencapai batas saat ini. Status ini hilang saat cooldown berakhir. Jalankan npx freellmapi doctor untuk memastikan permintaan dari klien mencapai gateway. Log permintaan di dashboard menampilkan setiap panggilan dari OpenCode. Header respons X-Routed-Via menyebutkan penyedia dan model yang menjawab setiap permintaan. Jika sebuah permintaan berpindah karena gagal, header X-Fallback-Trail menyebutkan setiap hop yang gagal beserta alasannya.

Setup manual: blok provider opencode.json

Untuk mengatur secara manual, tambahkan blok ini ke ~/.config/opencode/opencode.json, atau ke opencode.json di proyek Anda. OpenCode menggunakan @ai-sdk/openai-compatible untuk endpoint /v1/chat/completions.

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 }
        }
      }
    }
  }
}

Kemudian tambahkan kuncinya. Mulai OpenCode, jalankan /connect, pilih penyedia freellmapi, dan tempelkan kunci terpadu Anda. ID penyedia di /connect harus sama dengan ID di konfigurasi. Jalankan /models untuk memilih model.

  • limit.context adalah jumlah token input maksimum model. limit.output adalah jumlah token maksimum yang dapat dihasilkan model.
  • model tingkat atas menggunakan format provider/model. Tanpa itu, OpenCode mempertahankan model yang digunakan sebelumnya.
  • Setiap ID model yang ingin Anda gunakan harus ada di peta models. Tambahkan lebih banyak ID dari GET /v1/models.
Catatan tentang versi konfigurasi: dokumen OpenCode kini menjelaskan format konfigurasi V2 dengan kunci providers. Dokumen menyatakan bahwa format V1 di atas tetap didukung. Perintah setup FreeLLMAPI menulis format V1.

Pilih model untuk OpenCode

OpenCode adalah agent. Agent ini membaca file, mengeditnya, dan menjalankan perintah melalui panggilan tool. Setiap permintaan membawa system prompt, definisi tool, dan isi file. Gunakan model dengan tool calling dan jendela konteks yang besar.

Model gratis untuk OpenCode: tool calling dan konteks 128K+
ModelGratis diKonteksBatas gratis (penawaran terbaik)AlatPemrosesan gambar
GLM 5.3UnoRouter1M1 permintaan/menit
1 req/min per model
YaTidak
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 permintaan/menit
40 RPM
YaYa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaYaYa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceYaTidak
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditYaYa
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditYaYa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 permintaan/menit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/menit
50 permintaan/hari
Shared rate limit
YaTidak
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 permintaan/menit
250 permintaan/hari
70,000 token/menit
~6M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/menit
20 permintaan/hari
250,000 token/menit
~3M
YaYa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayYaYa

Menampilkan 12 dari 109 model gratis yang cocok. Lihat semua model.

Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.

Gunakan freellmapi/auto agar router memilih model untuk setiap permintaan. Tambahkan auto:smart atau auto:fast ke peta models untuk mengarahkan permintaan berdasarkan kecerdasan atau kecepatan. Anda juga dapat menambahkan profil bernama, misalnya auto:coding, setelah membuatnya di dashboard.

Batas laju dan sesi panjang

Satu tugas agent dapat mengirim puluhan permintaan. Satu tier gratis dapat menghentikan tugas panjang dengan cepat. FreeLLMAPI menghitung permintaan dan token setiap kunci. Saat sebuah penyedia mengirim error 429, router meneruskan permintaan ke model berikutnya dalam rantai, dan sesi berlanjut.

  • Tambahkan kunci dari empat penyedia atau lebih. Lebih banyak penyedia memberi lebih banyak permintaan per hari.
  • Aktifkan context handoff dengan FREELLMAPI_CONTEXT_HANDOFF=on_model_switch di .env FreeLLMAPI. Saat model berganti, model berikutnya menerima catatan singkat bahwa ia melanjutkan tugas.
  • Sticky session mempertahankan percakapan pada satu model selama 30 menit. Ini menjaga agent tetap konsisten.
  • Mulai sesi baru untuk setiap tugas. Konteks yang lebih kecil menggunakan lebih sedikit token per permintaan.

Pemecahan masalah

MasalahPenyebabSolusi
"Invalid API key" dengan kunci yang validapiKey yang kosong di konfigurasi menimpa kunci dari /connectHapus apiKey dari options, atau jalankan setup-opencode lagi
OpenCode tidak menggunakan penyedia barumodel tingkat atas belum diaturAtur "model": "freellmapi/auto"
Model not foundID model tidak ada di peta models penyediaTambahkan ID ke peta, atau jalankan setup-opencode lagi
Kunci {env:VAR} kosongOpenCode mengganti variabel yang tidak diatur dengan string kosongEkspor variabel di shell yang sama, atau simpan kunci dengan /connect
Tool calling gagalModel memiliki tool calling yang lemahPilih model dari tabel di atas
Pesan "All models rate-limited after N attempts"Semua kunci sudah mencapai batasnyaTambahkan kunci dari lebih banyak penyedia, atau tunggu cooldown
Gunakan semua ini melalui satu kunci. FreeLLMAPI adalah router sumber terbuka yang Anda hosting sendiri. Router ini menempatkan semua paket gratis ini di balik satu endpoint yang kompatibel dengan OpenAI, dan beralih ke penyedia lain saat batas permintaan tercapai. Lihat katalog atau mulai.

Pertanyaan yang sering diajukan

Bisakah saya menggunakan OpenCode secara gratis?

Bisa. OpenCode bersifat open source. Hubungkan ke FreeLLMAPI sebagai penyedia yang kompatibel dengan OpenAI. Gateway mengirim setiap permintaan ke tier penyedia gratis, sehingga biaya inferensi $0.

Bagaimana cara menambahkan penyedia kustom yang kompatibel dengan OpenAI ke OpenCode?

Tambahkan penyedia dengan npm yang diatur ke @ai-sdk/openai-compatible, options.baseURL, dan peta models ke opencode.json. Kemudian jalankan /connect untuk menyimpan kunci dan /models untuk memilih model.

Model gratis mana yang terbaik untuk OpenCode?

Gunakan model dengan tool calling dan konteks minimal 128K. Tabel di halaman ini menunjukkan model gratis terkuat yang memenuhi kedua aturan tersebut saat ini. Gunakan freellmapi/auto agar router memilih salah satunya.

Di mana OpenCode menyimpan kunci API?

Kunci yang ditambahkan dengan /connect disimpan di ~/.local/share/opencode/auth.json. Perintah setup FreeLLMAPI menulis kunci di sana, sehingga CLI dan aplikasi desktop sama-sama menemukannya.

Panduan terkait

Sumber

Semua panduan · Lihat semua model gratis