Trang chủ / Hướng dẫn / Dùng model AI miễn phí trong Zed

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áchCài đặt ZedEndpoint FreeLLMAPIKhóa
Nhà cung cấp tương thích OpenAI (khuyến nghị)language_models.openai_compatiblehttp://localhost:3001/v1Khó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 Ollamalanguage_models.ollamahttp://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 | bash

Cá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 settings từ 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 ID freellmapi, 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>
zed

Thê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.

  1. Trên bảng điều khiển FreeLLMAPI, mở Keys, Agents.
  2. Đặt giả lập Ollama thành open-loopback hoặc key-required.
  3. Thêm khối bên dưới vào settings.json của Zed.
  4. 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-loopback khô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-loopback từ chối yêu cầu qua cổng đã công bố. Dùng key-required và đặt OLLAMA_API_KEY bằ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. Đặt context_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.

Model miễn phí cho bảng agent của Zed: gọi công cụ và ngữ cảnh 128K trở lên
Mô hìnhMiễn phí trênNgữ cảnhGiới hạn miễn phí (ưu đãi tốt nhất)Công cụThị giác
GLM 5.3UnoRouter1M1 yêu cầu/phút
1 req/min per model
CóKhông
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 yêu cầu/phút
40 RPM
CóCó
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaCóCó
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceCóKhông
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditCóCó
Gemini 3.7 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditCóCó
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 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 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 yêu cầu/phút
50 yêu cầu/ngày
Shared rate limit
CóKhông
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 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.

Dự đoán chỉnh sửa: Zed có thể gửi dự đoán chỉnh sửa tới máy chủ Ollama hoặc tới endpoint /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:3001 và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ânCá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 modelCô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àoGiả lập Ollama tắt trong FreeLLMAPIBật nó trong Keys, Agents
Yêu cầu Ollama bị từ chối từ Dockeropen-loopback chỉ chấp nhận đối tượng loopbackDùng key-required với khóa thống nhất của bạn
Prompt dài bị mất ngữ cảnhnum_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ạnThêm khóa từ nhiều nhà cung cấp hơn, hoặc chờ thời gian nghỉ
Dùng tất cả các mô hình này qua một khóa duy nhất. FreeLLMAPI là bộ định tuyến mã nguồn mở, tự lưu trữ. Nó đặt tất cả các gói miễn phí này sau một endpoint duy nhất tương thích OpenAI, và tự chuyển sang nhà cung cấp khác khi một nhà cung cấp bị giới hạn tốc độ. Xem danh mục hoặc bắt đầu.

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

Nguồn

Tất cả hướng dẫn · Xem tất cả mô hình miễn phí