Dùng model AI miễn phí trong Zed
Zed là trình soạn thảo mã nguồn mở có bảng agent. Nó có thể dùng nhà cung cấp tương thích OpenAI hoặc máy chủ Ollama. Hướng dẫn này kết nối Zed với model miễn phí qua FreeLLMAPI bằng một trong hai cách. Một phần ngắn ở cuối nói về JetBrains AI Assistant.
Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.
Hai cách kết nối Zed
| Cách | Cài đặt Zed | Endpoint FreeLLMAPI | Khóa |
|---|---|---|---|
| Nhà cung cấp tương thích OpenAI (khuyến nghị) | language_models.openai_compatible | http://localhost:3001/v1 | Khóa thống nhất, trong giao diện cài đặt của Zed hoặc biến môi trường |
| Nhà cung cấp Ollama | language_models.ollama | http://localhost:3001 (giả lập Ollama) | Không có trên loopback, hoặc khóa thống nhất |
Cả hai cách dùng cùng bộ định tuyến và cùng nhóm model miễn phí. Cách tương thích OpenAI không cần thay đổi phía FreeLLMAPI. Cách Ollama cần giả lập Ollama, và tính năng này mặc định tắt.
Trước tiên cài đặt FreeLLMAPI. Mở http://localhost:3001, thêm ít nhất hai khóa nhà cung cấp miễn phí ở trang Keys và sao chép khóa thống nhất của bạn.
Cài đặt trên macOS hoặc Linux
curl -fsSL https://freellmapi.co/install.sh | bashCách 1: Nhà cung cấp tương thích OpenAI
Mở settings.json của Zed và thêm khối này. ID nhà cung cấp là freellmapi. max_tokens là cửa sổ ngữ cảnh của model.
settings.json của 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
}
}
]
}
}
}
}Đừng đặt khóa vào settings.json. Dùng một trong hai cách sau:
- Chạy
agent: open settingstừ bảng lệnh. Vào mục nhà cung cấp LLM, tìm nhà cung cấp và nhập khóa. Zed lưu khóa trong keychain của hệ thống. - Đặt biến môi trường. Zed tạo tên từ ID nhà cung cấp viết hoa kiểu snake case cộng với
_API_KEY. Với IDfreellmapi, tên làFREELLMAPI_API_KEY. Biến này được ưu tiên hơn keychain.
Khóa dạng biến môi trường
export FREELLMAPI_API_KEY=<unified-key>
zedThêm một mục trong available_models cho mỗi model bạn muốn có trong menu model. auto:smart và auto:fast cũng là tên hợp lệ.
Cách 2: Giả lập Ollama
FreeLLMAPI có thể hoạt động như máy chủ Ollama. Nó phục vụ /api/tags, /api/chat, /api/generate, /api/show, /api/version và /api/embed. Streaming dùng JSON phân tách bằng dòng mới, giống Ollama.
- Trên bảng điều khiển FreeLLMAPI, mở Keys, Agents.
- Đặt giả lập Ollama thành
open-loopbackhoặckey-required. - Thêm khối bên dưới vào
settings.jsoncủa Zed. - Mở bảng agent và chọn một model.
settings.json của Zed
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopbackkhông cần khóa, nhưng chỉ cho yêu cầu từ máy tính này.- Nếu FreeLLMAPI chạy trong Docker,
open-loopbacktừ chối yêu cầu qua cổng đã công bố. Dùngkey-requiredvà đặtOLLAMA_API_KEYbằng khóa thống nhất của bạn, hoặc nhập khóa trong giao diện nhà cung cấp. - Zed gửi kích thước ngữ cảnh dưới dạng
num_ctx. Mặc định là 4096 token, quá nhỏ cho công việc agent. Đặtcontext_window.
Chọn model cho bảng agent
Tài liệu Zed nói rằng mỗi model và nhà cung cấp phải hỗ trợ gọi công cụ. Model không hỗ trợ công cụ hiển thị nhãn "No tools" trong bảng agent. Dùng model có gọi công cụ và cửa sổ ngữ cảnh lớn.
| Mô hình | Miễn phí trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 yêu cầu/phút 1 req/min per model | Có | Không |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 yêu cầu/phút 40 RPM | Có | Có |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Có | Có |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Có | Không |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 yêu cầu/phút 50 yêu cầu/ngày 50 req/day account-wide (1,000 after a $10 purchase) | Có | Có |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 yêu cầu/phút 50 yêu cầu/ngày Shared rate limit | Có | Không |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 yêu cầu/phút 250 yêu cầu/ngày 70,000 token/phút ~6M | Có | Có |
Đang hiển thị 10 trong số 109 mô hình miễn phí phù hợp. Xem tất cả mô hình.
Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.
Gói miễn phí có giới hạn mỗi phút và mỗi ngày. Khi một nhà cung cấp gửi lỗi 429, FreeLLMAPI thử model tiếp theo trong chuỗi của bạn. Thêm khóa từ bốn nhà cung cấp trở lên cho các phiên agent dài.
/v1/completions tương thích OpenAI. FreeLLMAPI phục vụ cả hai. Tài liệu dự đoán chỉnh sửa của Zed không có trường khóa API cho hai nhà cung cấp này. Chúng tôi chưa xác nhận sự kết hợp này với FreeLLMAPI, vì vậy hãy kiểm tra trước khi phụ thuộc vào nó.JetBrains AI Assistant
JetBrains AI Assistant có thể dùng nhà cung cấp tương thích OpenAI hoặc máy chủ Ollama cục bộ. Mở Settings, Tools, AI Assistant, Providers & API keys. Có hai tùy chọn:
- Dùng khóa riêng, tương thích OpenAI: nhập base URL
http://localhost:3001/v1, khóa thống nhất của bạn và một model ID nhưauto. Tài liệu JetBrains nói rằng BYOK hoạt động với agent mà không cần đăng ký JetBrains AI. - Ollama: trong Third-party AI providers, chọn Ollama. Nhập
http://localhost:3001vào trường URL và nhấn Test Connection. Sau đó gán model trong Models Assignment. Bật giả lập Ollama trong FreeLLMAPI trước.
Tài liệu JetBrains nêu giới hạn cho model cục bộ: agent không dùng được chúng, và AI Assistant không gọi được công cụ MCP với chúng. Gợi ý hoàn thành inline và gợi ý chỉnh sửa tiếp theo mặc định dùng model của JetBrains. Với công việc agent, dùng tùy chọn BYOK.
Khắc phục sự cố
| Vấn đề | Nguyên nhân | Cách khắc phục |
|---|---|---|
401 "Invalid API key" | Zed không có khóa cho nhà cung cấp, hoặc khóa sai | Đặt FREELLMAPI_API_KEY, hoặc nhập khóa trong cài đặt agent |
| Nhãn "No tools" trên model | Công cụ tắt cho model, hoặc model không gọi công cụ | Đặt "tools": true và dùng một model từ bảng |
| Nhà cung cấp Ollama không hiển thị model nào | Giả lập Ollama tắt trong FreeLLMAPI | Bật nó trong Keys, Agents |
| Yêu cầu Ollama bị từ chối từ Docker | open-loopback chỉ chấp nhận đối tượng loopback | Dùng key-required với khóa thống nhất của bạn |
| Prompt dài bị mất ngữ cảnh | num_ctx là 4096 token | Đặt context_window trong cài đặt Ollama |
| Thông báo "Tất cả model bị giới hạn tốc độ sau N lần thử" | Mọi khóa đều hết giới hạn | Thêm khóa từ nhiều nhà cung cấp hơn, hoặc chờ thời gian nghỉ |
Câu hỏi thường gặp
Tôi có thể dùng LLM tùy chỉnh trong Zed không?
Có. Thêm một nhà cung cấp openai_compatible với api_url và available_models vào language_models trong settings.json. Zed cũng hỗ trợ nhà cung cấp Ollama với api_url tùy chỉnh.
Làm sao để dùng model AI miễn phí trong Zed?
Trỏ nhà cung cấp tương thích OpenAI tới FreeLLMAPI tại http://localhost:3001/v1. Cổng gửi mỗi yêu cầu tới các gói miễn phí của nhà cung cấp, nên chi phí suy luận là $0.
Zed lưu khóa API của nhà cung cấp tùy chỉnh ở đâu?
Zed lưu khóa bạn nhập trong cài đặt agent vào keychain của hệ thống. Bạn cũng có thể đặt biến môi trường có tên theo ID nhà cung cấp, ví dụ FREELLMAPI_API_KEY.
JetBrains AI Assistant có hoạt động với model miễn phí không?
Có. Dùng Bring your own key với base URL tương thích OpenAI, hoặc nhà cung cấp Ollama. Tài liệu JetBrains nói rằng agent không dùng được model cục bộ, vì vậy hãy dùng BYOK cho công việc agent.
Hướng dẫn liên quan
- Mô hình AI miễn phí trong VS Code
- Continue với API LLM miễn phí
- Cline, Roo Code và Kilo Code với API miễn phí
- API model lập trình miễn phí tốt nhất
- Base URL API tương thích OpenAI miễn phí
Nguồn
- Zed docs: use API access (OpenAI-compatible providers) (đã kiểm tra 20 November 2026)
- Zed docs: use a local model (Ollama) (đã kiểm tra 20 November 2026)
- Zed docs: agent panel (đã kiểm tra 20 November 2026)
- Zed docs: edit prediction (đã kiểm tra 20 November 2026)
- JetBrains AI Assistant: use custom models (đã kiểm tra 20 November 2026)
- JetBrains AI Assistant: bring your own key (đã kiểm tra 20 November 2026)
- FreeLLMAPI docs: Ollama clients (đã kiểm tra 20 November 2026)