Laman utama / Panduan / Guna OpenCode dengan API LLM percuma

Guna OpenCode dengan API LLM percuma

OpenCode ialah ejen pengekodan sumber terbuka untuk terminal dan desktop. Ia menerima mana-mana penyedia yang serasi dengan OpenAI. Panduan ini menyambungkan OpenCode kepada model percuma melalui FreeLLMAPI. Satu arahan menulis konfigurasi dan menyimpan kunci.

Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.

Langkah 1: Pasang FreeLLMAPI

FreeLLMAPI ialah gerbang sumber terbuka. Ia dijalankan pada komputer anda dalam Docker dan menghimpunkan tier percuma bagi 45 penyedia di sebalik satu kunci.

Pasang pada macOS atau Linux

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

Buka http://localhost:3001. Tambah sekurang-kurangnya dua kunci penyedia percuma pada halaman Keys. Google AI Studio dan Groq masing-masing memberikan kunci percuma dalam beberapa minit. Salin kunci bersatu anda daripada halaman yang sama.

Langkah 2: Sambungkan OpenCode dengan satu arahan

Satu arahan

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

Arahan ini melakukan tiga perkara:

  • Ia menambah penyedia freellmapi pada ~/.config/opencode/opencode.json. Penyedia itu menyenaraikan model daripada katalog langsung anda beserta had konteksnya.
  • Ia menetapkan freellmapi/auto sebagai model lalai.
  • Ia menyimpan kunci dalam fail kelayakan OpenCode, ~/.local/share/opencode/auth.json. Anda tidak perlukan pembolehubah persekitaran, sama ada dalam CLI atau aplikasi desktop.

Arahan ini membuat sandaran sebelum menulis. Ia menggabungkan penyedia baharu, jadi penyedia lain anda kekal. Jika XDG_CONFIG_HOME atau XDG_DATA_HOME ditetapkan, arahan ini menggunakan folder tersebut.

Sebelum anda memulakan tugasan panjang, pastikan gerbang boleh melayan permintaan sekarang. Panggilan ini hanya menyenaraikan model yang mempunyai kunci boleh guna pada masa ini:

Semak model yang sedia

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

Model dengan status exhausted mempunyai kunci, tetapi semuanya telah mencapai had sekarang. Status ini hilang apabila tempoh rehat tamat. Jalankan npx freellmapi doctor untuk memastikan permintaan klien sampai ke gerbang. Log permintaan papan pemuka menunjukkan setiap panggilan daripada OpenCode. Pengepala respons X-Routed-Via menamakan penyedia dan model yang menjawab setiap permintaan. Jika satu permintaan beralih ke penyedia lain, pengepala X-Fallback-Trail menamakan setiap lompatan yang gagal dan sebabnya.

Persediaan manual: blok penyedia opencode.json

Untuk menyediakannya secara manual, tambah blok ini pada ~/.config/opencode/opencode.json, atau pada opencode.json dalam projek anda. OpenCode menggunakan @ai-sdk/openai-compatible untuk titik akhir /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 tambah kunci. Mulakan OpenCode, jalankan /connect, pilih penyedia freellmapi dan tampal kunci bersatu anda. ID penyedia dalam /connect mesti sepadan dengan ID dalam konfigurasi. Jalankan /models untuk memilih model.

  • limit.context ialah bilangan token input maksimum bagi model itu. limit.output ialah bilangan token maksimum yang boleh dijana olehnya.
  • model peringkat atas menggunakan format provider/model. Tanpa ini, OpenCode mengekalkan model yang digunakannya sebelum ini.
  • Setiap ID model yang anda mahu guna mesti ada dalam peta models. Tambah lebih banyak ID daripada GET /v1/models.
Nota tentang versi konfigurasi: dokumentasi OpenCode kini menerangkan format konfigurasi V2 dengan kunci providers. Dokumentasi menyatakan bahawa format V1 di atas masih disokong. Arahan persediaan FreeLLMAPI menulis format V1.

Pilih model untuk OpenCode

OpenCode ialah ejen. Ia membaca fail, mengeditnya dan menjalankan arahan melalui panggilan alat. Setiap permintaan membawa gesaan sistem, takrif alat dan kandungan fail. Guna model dengan panggilan alat dan tetingkap konteks yang besar.

Model percuma untuk OpenCode: panggilan alat dan konteks 128K+
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
GLM 5.3UnoRouter1M1 permintaan/minit
1 req/min per model
YaTidak
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 permintaan/minit
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/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditYaYa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 permintaan/minit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/minit
50 permintaan/hari
Shared rate limit
YaTidak
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 permintaan/minit
250 permintaan/hari
70,000 token/minit
~6M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayYaYa

Memaparkan 12 daripada 109 model percuma yang sepadan. Lihat semua model.

Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.

Guna freellmapi/auto untuk membenarkan penghala memilih model bagi setiap permintaan. Tambah auto:smart atau auto:fast pada peta models untuk mengarahkan permintaan mengikut kecerdasan atau kelajuan. Anda juga boleh menambah profil bernama, contohnya auto:coding, selepas anda mencipta profil itu pada papan pemuka.

Had kadar dan sesi panjang

Satu tugasan ejen boleh menghantar berpuluh permintaan. Satu tier percuma sahaja boleh menghentikan tugasan panjang dengan cepat. FreeLLMAPI mengira permintaan dan token bagi setiap kunci. Apabila satu penyedia menghantar ralat 429, penghala menghantar permintaan itu ke model seterusnya dalam rantaian, dan sesi diteruskan.

  • Tambah kunci daripada empat penyedia atau lebih. Lebih banyak penyedia memberikan lebih banyak permintaan sehari.
  • Hidupkan serahan konteks dengan FREELLMAPI_CONTEXT_HANDOFF=on_model_switch dalam .env FreeLLMAPI. Apabila model bertukar, model seterusnya menerima nota ringkas bahawa ia meneruskan satu tugasan.
  • Sesi melekat mengekalkan satu perbualan pada satu model selama 30 minit. Ini menjadikan ejen konsisten.
  • Mulakan sesi baharu bagi setiap tugasan. Konteks yang lebih kecil menggunakan lebih sedikit token bagi setiap permintaan.

Penyelesaian masalah

MasalahPuncaPenyelesaian
"Invalid API key" dengan kunci yang sahapiKey yang kosong dalam konfigurasi menggantikan kunci daripada /connectBuang apiKey daripada options, atau jalankan setup-opencode sekali lagi
OpenCode tidak menggunakan penyedia baharumodel peringkat atas tidak ditetapkanTetapkan "model": "freellmapi/auto"
Model not foundID model tiada dalam peta models penyediaTambah ID itu pada peta, atau jalankan setup-opencode sekali lagi
Kunci {env:VAR} kosongOpenCode menggantikan pembolehubah yang tidak ditetapkan dengan rentetan kosongEksport pembolehubah itu dalam shell yang sama, atau simpan kunci dengan /connect
Panggilan alat gagalModel mempunyai panggilan alat yang lemahPilih model daripada jadual di atas
"Semua model dihadkan kadar selepas N percubaan"Semua kunci telah mencapai hadTambah kunci daripada lebih banyak penyedia, atau tunggu tempoh rehat
Guna setiap satu daripada ini melalui satu kunci. FreeLLMAPI ialah penghala sumber terbuka yang anda hoskan sendiri. Ia meletakkan semua peringkat percuma ini di belakang satu titik akhir serasi OpenAI dan beralih ke pembekal lain apabila had kadar dicapai. Layari katalog atau mula sekarang.

Soalan lazim

Bolehkah saya guna OpenCode secara percuma?

Boleh. OpenCode ialah sumber terbuka. Sambungkannya kepada FreeLLMAPI sebagai penyedia yang serasi dengan OpenAI. Gerbang menghantar setiap permintaan ke tier percuma penyedia, jadi kos inferens ialah $0.

Bagaimana saya menambah penyedia OpenAI-compatible tersuai pada OpenCode?

Tambah penyedia pada opencode.json dengan npm ditetapkan kepada @ai-sdk/openai-compatible, options.baseURL dan peta models. Kemudian jalankan /connect untuk menyimpan kunci dan /models untuk memilih model.

Model percuma yang manakah terbaik untuk OpenCode?

Guna model dengan panggilan alat dan sekurang-kurangnya 128K konteks. Jadual dalam halaman ini menunjukkan model percuma terkuat yang memenuhi kedua-dua syarat hari ini. Guna freellmapi/auto untuk membenarkan penghala memilih satu.

Di mana OpenCode menyimpan kunci API?

Kunci yang ditambah dengan /connect pergi ke ~/.local/share/opencode/auth.json. Arahan persediaan FreeLLMAPI menulis kunci di situ, jadi CLI dan aplikasi desktop kedua-duanya menjumpainya.

Panduan berkaitan

Sumber

Semua panduan · Lihat semua model percuma