Guna model AI percuma dalam Zed
Zed ialah editor kod sumber terbuka dengan panel ejen. Ia boleh menggunakan pembekal yang serasi dengan OpenAI atau pelayan Ollama. Panduan ini menyambungkan Zed kepada model percuma melalui FreeLLMAPI dengan salah satu kaedah. Bahagian pendek di hujung meliputi JetBrains AI Assistant.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Dua cara untuk menyambung Zed
| Kaedah | Tetapan Zed | Titik akhir FreeLLMAPI | Kunci |
|---|---|---|---|
| Pembekal yang serasi dengan OpenAI (disyorkan) | language_models.openai_compatible | http://localhost:3001/v1 | Kunci bersatu, dalam UI tetapan Zed atau pembolehubah persekitaran |
| Pembekal Ollama | language_models.ollama | http://localhost:3001 (emulasi Ollama) | Tiada pada loopback, atau kunci bersatu |
Kedua-dua kaedah menggunakan penghala yang sama dan kumpulan model percuma yang sama. Kaedah yang serasi dengan OpenAI tidak memerlukan perubahan di pihak FreeLLMAPI. Kaedah Ollama memerlukan emulasi Ollama, yang dimatikan secara lalai.
Pasang FreeLLMAPI dahulu. Buka http://localhost:3001, tambah sekurang-kurangnya dua kunci pembekal percuma pada halaman Keys dan salin kunci bersatu anda.
Pasang pada macOS atau Linux
curl -fsSL https://freellmapi.co/install.sh | bashKaedah 1: Pembekal yang serasi dengan OpenAI
Buka settings.json Zed anda dan tambah blok ini. ID pembekal ialah freellmapi. max_tokens ialah tetingkap konteks model.
Zed settings.json
{
"language_models": {
"openai_compatible": {
"freellmapi": {
"api_url": "http://localhost:3001/v1",
"available_models": [
{
"name": "auto",
"display_name": "FreeLLMAPI Auto",
"max_tokens": 128000,
"max_output_tokens": 8192,
"capabilities": {
"tools": true,
"images": false,
"parallel_tool_calls": false,
"prompt_cache_key": false,
"chat_completions": true
}
}
]
}
}
}
}Jangan letakkan kunci dalam settings.json. Guna salah satu daripada dua kaedah ini:
- Jalankan
agent: open settingsdaripada palet arahan. Pergi ke pembekal LLM, cari pembekal dan masukkan kunci. Zed menyimpannya dalam rantai kunci sistem. - Tetapkan pembolehubah persekitaran. Zed membina nama daripada ID pembekal dalam huruf besar dengan garis bawah, ditambah
_API_KEY. Untuk IDfreellmapi, nama ialahFREELLMAPI_API_KEY. Pembolehubah ini mempunyai keutamaan berbanding rantai kunci.
Kunci sebagai pembolehubah persekitaran
export FREELLMAPI_API_KEY=<unified-key>
zedTambah satu entri dalam available_models untuk setiap model yang anda mahu dalam menu model. auto:smart dan auto:fast juga nama yang sah.
Kaedah 2: Emulasi Ollama
FreeLLMAPI boleh bertindak sebagai pelayan Ollama. Ia menyediakan /api/tags, /api/chat, /api/generate, /api/show, /api/version dan /api/embed. Streaming menggunakan JSON dipisahkan baris baharu, sama seperti Ollama.
- Pada papan pemuka FreeLLMAPI, buka Keys, Agents.
- Tetapkan emulasi Ollama kepada
open-loopbackataukey-required. - Tambah blok di bawah ke dalam
settings.jsonZed. - Buka panel ejen dan pilih model.
Zed settings.json
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopbacktidak memerlukan kunci, tetapi hanya untuk permintaan daripada komputer ini.- Jika FreeLLMAPI berjalan dalam Docker,
open-loopbackmenolak permintaan melalui port yang diterbitkan. Gunakey-requireddan tetapkanOLLAMA_API_KEYkepada kunci bersatu anda, atau masukkannya dalam UI pembekal. - Zed menghantar saiz konteks sebagai
num_ctx. Lalainya ialah 4096 token, yang terlalu kecil untuk kerja ejen. Tetapkancontext_window.
Pilih model untuk panel ejen
Dokumentasi Zed menyatakan bahawa setiap model dan pembekal mesti menyokong panggilan alat. Model tanpa sokongan alat memaparkan label "No tools" dalam panel ejen. Guna model dengan panggilan alat dan tetingkap konteks yang besar.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/minit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/minit 40 RPM | Ya | Ya |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ya | Tidak |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 permintaan/minit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
Memaparkan 10 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.
Peringkat percuma mempunyai had seminit dan sehari. Apabila pembekal menghantar ralat 429, FreeLLMAPI mencuba model seterusnya dalam rantai anda. Tambah kunci daripada empat pembekal atau lebih untuk sesi ejen yang panjang.
/v1/completions yang serasi dengan OpenAI. FreeLLMAPI menyediakan kedua-duanya. Dokumentasi ramalan sunting Zed tidak menunjukkan medan kunci API untuk kedua-dua pembekal ini. Kami belum mengesahkan gabungan ini dengan FreeLLMAPI, jadi uji dahulu sebelum anda bergantung padanya.JetBrains AI Assistant
JetBrains AI Assistant boleh menggunakan pembekal yang serasi dengan OpenAI atau pelayan Ollama tempatan. Buka Settings, Tools, AI Assistant, Providers & API keys. Terdapat dua pilihan:
- Bawa kunci anda sendiri, serasi dengan OpenAI: masukkan base URL
http://localhost:3001/v1, kunci bersatu anda dan ID model sepertiauto. Dokumentasi JetBrains menyatakan bahawa BYOK berfungsi dengan ejen tanpa langganan JetBrains AI. - Ollama: dalam Third-party AI providers, pilih Ollama. Masukkan
http://localhost:3001dalam medan URL dan klik Test Connection. Kemudian tetapkan model dalam Models Assignment. Hidupkan emulasi Ollama dalam FreeLLMAPI dahulu.
Dokumentasi JetBrains memberikan had untuk model tempatan: ejen tidak boleh menggunakannya, dan AI Assistant tidak boleh memanggil alat MCP dengannya. Cadangan pelengkapan sebaris dan sunting seterusnya menggunakan model JetBrains secara lalai. Untuk kerja ejen, guna pilihan BYOK.
Penyelesaian masalah
| Masalah | Punca | Penyelesaian |
|---|---|---|
401 "Invalid API key" | Zed tiada kunci untuk pembekal itu, atau kunci salah | Tetapkan FREELLMAPI_API_KEY, atau masukkan kunci dalam tetapan ejen |
| Label "No tools" pada model | Alat dimatikan untuk model itu, atau model tiada panggilan alat | Tetapkan "tools": true dan guna model dari jadual |
| Pembekal Ollama tidak menunjukkan model | Emulasi Ollama dimatikan dalam FreeLLMAPI | Hidupkannya dalam Keys, Agents |
| Permintaan Ollama ditolak daripada Docker | open-loopback hanya menerima peer loopback | Guna key-required dengan kunci bersatu anda |
| Prompt panjang kehilangan konteks | num_ctx ialah 4096 token | Tetapkan context_window dalam tetapan Ollama |
| "Semua model mencapai had kadar selepas N percubaan" | Semua kunci telah mencapai had | Tambah kunci daripada lebih banyak pembekal, atau tunggu tempoh rehat |
Soalan lazim
Bolehkah saya guna LLM tersuai dalam Zed?
Boleh. Tambah pembekal openai_compatible dengan api_url dan available_models di bawah language_models dalam settings.json. Zed juga menyokong pembekal Ollama dengan api_url tersuai.
Bagaimana saya guna model AI percuma dalam Zed?
Tunjukkan pembekal yang serasi dengan OpenAI kepada FreeLLMAPI pada http://localhost:3001/v1. Gerbang menghantar setiap permintaan ke peringkat pembekal percuma, jadi kos inferens ialah $0.
Di mana Zed menyimpan kunci API untuk pembekal tersuai?
Zed menyimpan kunci yang anda masukkan dalam tetapan ejen dalam rantai kunci sistem. Anda juga boleh menetapkan pembolehubah persekitaran yang dinamakan mengikut ID pembekal, contohnya FREELLMAPI_API_KEY.
Adakah JetBrains AI Assistant berfungsi dengan model percuma?
Ya. Guna Bring your own key dengan base URL yang serasi dengan OpenAI, atau pembekal Ollama. Dokumentasi JetBrains menyatakan bahawa ejen tidak boleh menggunakan model tempatan, jadi guna BYOK untuk kerja ejen.
Panduan berkaitan
- Model AI percuma dalam VS Code
- Continue dengan API LLM percuma
- Cline, Roo Code dan Kilo Code dengan API percuma
- Model API pengekodan percuma terbaik
- Base URL API percuma yang serasi dengan OpenAI
Sumber
- Zed docs: use API access (OpenAI-compatible providers) (disemak 20 November 2026)
- Zed docs: use a local model (Ollama) (disemak 20 November 2026)
- Zed docs: agent panel (disemak 20 November 2026)
- Zed docs: edit prediction (disemak 20 November 2026)
- JetBrains AI Assistant: use custom models (disemak 20 November 2026)
- JetBrains AI Assistant: bring your own key (disemak 20 November 2026)
- FreeLLMAPI docs: Ollama clients (disemak 20 November 2026)