استفاده از مدلهای AI رایگان در Zed
Zed یک ویرایشگر کد متنباز با یک پنل عامل است. میتواند از یک ارائهدهنده سازگار با OpenAI یا یک سرور Ollama استفاده کند. این راهنما Zed را با هر یک از این دو روش به مدلهای رایگان از طریق FreeLLMAPI وصل میکند. بخش کوتاه پایانی، دستیار JetBrains AI را پوشش میدهد.
کد، نام مدلها و برچسبهای زندهٔ کاتالوگ به زبان انگلیسی نمایش داده میشوند.
دو روش برای اتصال Zed
| روش | تنظیم Zed | نقطه پایانی FreeLLMAPI | کلید |
|---|---|---|---|
| ارائهدهنده سازگار با OpenAI (پیشنهادی) | language_models.openai_compatible | http://localhost:3001/v1 | کلید یکپارچه، در رابط تنظیمات Zed یا یک متغیر محیطی |
| ارائهدهنده Ollama | language_models.ollama | http://localhost:3001 (شبیهسازی Ollama) | بدون کلید روی loopback، یا کلید یکپارچه |
هر دو روش از یک مسیریاب و یک استخر مدل رایگان استفاده میکنند. روش سازگار با OpenAI هیچ تغییری در سمت FreeLLMAPI لازم ندارد. روش Ollama به شبیهسازی Ollama نیاز دارد که بهطور پیشفرض خاموش است.
ابتدا FreeLLMAPI را نصب کنید. http://localhost:3001 را باز کنید، حداقل دو کلید رایگان ارائهدهنده را در صفحه Keys اضافه کنید و کلید یکپارچه خود را کپی کنید.
نصب روی macOS یا Linux
curl -fsSL https://freellmapi.co/install.sh | bashروش 1: ارائهدهنده سازگار با OpenAI
فایل settings.json Zed خود را باز کنید و این بلوک را اضافه کنید. شناسه ارائهدهنده freellmapi است. max_tokens پنجره زمینه مدل است.
settings.json در Zed
{
"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
}
}
]
}
}
}
}کلید را در settings.json قرار ندهید. از یکی از این دو روش استفاده کنید:
- از پالت فرمان، دستور
agent: open settingsرا اجرا کنید. به بخش ارائهدهندگان LLM بروید، ارائهدهنده را پیدا کنید و کلید را وارد کنید. Zed آن را در زنجیره کلیدهای سیستم نگه میدارد. - یک متغیر محیطی تنظیم کنید. Zed نام را از شناسه ارائهدهنده با حروف بزرگ و خط زیر، بهعلاوه
_API_KEYمیسازد. برای شناسهfreellmapi، نامFREELLMAPI_API_KEYاست. این متغیر بر زنجیره کلیدهای سیستم اولویت دارد.
کلید به عنوان متغیر محیطی
export FREELLMAPI_API_KEY=<unified-key>
zedبرای هر مدلی که میخواهید در منوی مدل باشد، یک ورودی در available_models اضافه کنید. auto:smart و auto:fast هم نامهای معتبر هستند.
روش 2: شبیهسازی Ollama
FreeLLMAPI میتواند مانند یک سرور Ollama عمل کند. این سرویس /api/tags، /api/chat، /api/generate، /api/show، /api/version و /api/embed را ارائه میدهد. استریم از JSON با جداکننده خط جدید استفاده میکند، مانند Ollama.
- در داشبورد FreeLLMAPI، صفحه Keys, Agents را باز کنید.
- شبیهسازی Ollama را روی
open-loopbackیاkey-requiredتنظیم کنید. - بلوک زیر را به
settings.jsonدر Zed اضافه کنید. - پنل عامل را باز کنید و یک مدل انتخاب کنید.
settings.json در Zed
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopbackبه کلید نیاز ندارد، اما فقط برای درخواستهای این رایانه کار میکند.- اگر FreeLLMAPI در Docker اجرا شود،
open-loopbackدرخواستهای رسیده از یک پورت منتشرشده را رد میکند. ازkey-requiredاستفاده کنید وOLLAMA_API_KEYرا روی کلید یکپارچه خود تنظیم کنید، یا آن را در رابط ارائهدهنده وارد کنید. - Zed اندازه زمینه را به صورت
num_ctxمیفرستد. مقدار پیشفرض 4096 توکن است که برای کار عامل خیلی کوچک است.context_windowرا تنظیم کنید.
انتخاب مدل برای پنل عامل
مستندات Zed میگوید هر مدل و ارائهدهنده باید فراخوانی ابزار را پشتیبانی کند. مدلی که از ابزار پشتیبانی نکند، برچسب «No tools» را در پنل عامل نشان میدهد. از مدلهایی با فراخوانی ابزار و پنجره زمینه بزرگ استفاده کنید.
| مدل | رایگان در | متن ورودی | محدودیتهای رایگان (بهترین پیشنهاد) | ابزارها | بینایی |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 درخواست در دقیقه 1 req/min per model | بله | خیر |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 درخواست در دقیقه 40 RPM | بله | بله |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | بله | بله |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | بله | خیر |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 درخواست در دقیقه 20 درخواست در روز 250,000 توکن در دقیقه ~3M | بله | بله |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | بله | بله |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 درخواست در دقیقه 50 درخواست در روز 50 req/day account-wide (1,000 after a $10 purchase) | بله | بله |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 درخواست در دقیقه 50 درخواست در روز Shared rate limit | بله | خیر |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 درخواست در دقیقه 250 درخواست در روز 70,000 توکن در دقیقه ~6M | بله | بله |
نمایش 10 مدل رایگان مطابق از 109 مدل. مشاهده همه مدلها.
دادههای زنده از کاتالوگ FreeLLMAPI (نسخه 2026.11.19، بررسیشده در 2026-11-19). محدودیتهای رایگان اغلب تغییر میکنند. کاتالوگ هر روز بررسی میشود.
سطوح رایگان محدودیت در دقیقه و در روز دارند. وقتی یک ارائهدهنده خطای 429 بفرستد، FreeLLMAPI مدل بعدی را در زنجیره شما امتحان میکند. برای جلسات طولانی عامل، کلیدهای چهار ارائهدهنده یا بیشتر اضافه کنید.
/v1/completions بفرستد. FreeLLMAPI هر دو را سرویس میدهد. مستندات پیشبینی ویرایش Zed برای این دو ارائهدهنده فیلد کلید API نشان نمیدهد. ما این ترکیب را با FreeLLMAPI تأیید نکردهایم، پس پیش از تکیه بر آن آزمایشش کنید.دستیار JetBrains AI
دستیار JetBrains AI میتواند از یک ارائهدهنده سازگار با OpenAI یا یک سرور محلی Ollama استفاده کند. Settings, Tools, AI Assistant, Providers & API keys را باز کنید. دو گزینه وجود دارد:
- کلید خودتان، سازگار با OpenAI: نشانی پایه
http://localhost:3001/v1، کلید یکپارچه خود و یک شناسه مدل مانندautoرا وارد کنید. مستندات JetBrains میگوید BYOK بدون اشتراک JetBrains AI با عاملها کار میکند. - Ollama: در Third-party AI providers، Ollama را انتخاب کنید.
http://localhost:3001را در فیلد URL وارد کنید و روی Test Connection کلیک کنید. سپس مدلها را در Models Assignment تعیین کنید. ابتدا شبیهسازی Ollama را در FreeLLMAPI روشن کنید.
مستندات JetBrains برای مدلهای محلی محدودیتهایی دارد: عاملها نمیتوانند از آنها استفاده کنند و AI Assistant نمیتواند با آنها ابزارهای MCP را صدا بزند. تکمیل درونخطی و پیشنهادهای ویرایش بعدی بهطور پیشفرض از مدلهای JetBrains استفاده میکنند. برای کار عامل، گزینه BYOK را استفاده کنید.
عیبیابی
| مشکل | علت | راهحل |
|---|---|---|
401 «Invalid API key» | Zed کلیدی برای ارائهدهنده ندارد، یا کلید اشتباه است | FREELLMAPI_API_KEY را تنظیم کنید، یا کلید را در تنظیمات عامل وارد کنید |
| برچسب «No tools» روی مدل | ابزارها برای مدل خاموش هستند، یا مدل فراخوانی ابزار ندارد | "tools": true را تنظیم کنید و از مدلی در جدول استفاده کنید |
| ارائهدهنده Ollama هیچ مدلی نشان نمیدهد | شبیهسازی Ollama در FreeLLMAPI خاموش است | آن را در Keys, Agents روشن کنید |
| درخواستهای Ollama از Docker رد میشوند | open-loopback فقط همتایان loopback را میپذیرد | از key-required با کلید یکپارچه خود استفاده کنید |
| پرامپتهای بلند زمینه را از دست میدهند | num_ctx برابر 4096 توکن است | context_window را در تنظیمات Ollama تنظیم کنید |
| «All models rate-limited after N attempts» | همه کلیدها به حد خود رسیدهاند | کلیدهای ارائهدهندگان بیشتری اضافه کنید، یا تا پایان دوره انتظار صبر کنید |
پرسشهای متداول
آیا میتوانم در Zed از یک LLM سفارشی استفاده کنم؟
بله. یک ارائهدهنده openai_compatible با api_url و available_models را زیر language_models در settings.json اضافه کنید. Zed یک ارائهدهنده Ollama با api_url سفارشی را هم پشتیبانی میکند.
چگونه از مدلهای AI رایگان در Zed استفاده کنم؟
یک ارائهدهنده سازگار با OpenAI را روی FreeLLMAPI در http://localhost:3001/v1 تنظیم کنید. این دروازه هر درخواست را به سطوح رایگان ارائهدهندگان میفرستد، پس هزینه استنتاج صفر دلار است.
Zed کلید API ارائهدهنده سفارشی را کجا ذخیره میکند؟
Zed کلیدی را که در تنظیمات عامل وارد میکنید، در زنجیره کلیدهای سیستم نگه میدارد. همچنین میتوانید یک متغیر محیطی با نامی بر اساس شناسه ارائهدهنده تنظیم کنید، برای مثال FREELLMAPI_API_KEY.
آیا دستیار JetBrains AI با مدلهای رایگان کار میکند؟
بله. از گزینه کلید خودتان با نشانی پایه سازگار با OpenAI، یا ارائهدهنده Ollama استفاده کنید. مستندات JetBrains میگوید عاملها نمیتوانند از مدلهای محلی استفاده کنند، پس برای کار عامل از BYOK استفاده کنید.
راهنماهای مرتبط
- مدلهای هوش مصنوعی رایگان در VS Code
- Continue با API رایگان LLM
- Cline، Roo Code و Kilo Code با یک API رایگان
- بهترین API مدلهای کدنویسی رایگان
- آدرسهای پایه API سازگار با OpenAI رایگان
منابع
- Zed docs: use API access (OpenAI-compatible providers) (بررسیشده در 20 November 2026)
- Zed docs: use a local model (Ollama) (بررسیشده در 20 November 2026)
- Zed docs: agent panel (بررسیشده در 20 November 2026)
- Zed docs: edit prediction (بررسیشده در 20 November 2026)
- JetBrains AI Assistant: use custom models (بررسیشده در 20 November 2026)
- JetBrains AI Assistant: bring your own key (بررسیشده در 20 November 2026)
- FreeLLMAPI docs: Ollama clients (بررسیشده در 20 November 2026)