Trang chủ / Hướng dẫn / Dùng Aider với API LLM miễn phí

Dùng Aider với API LLM miễn phí

Aider là trợ lý lập trình cặp mã nguồn mở chạy trong terminal. Nó chỉnh sửa tệp trong kho git của bạn và tạo commit. Hướng dẫn này kết nối Aider với model miễn phí qua FreeLLMAPI. Nó cũng cho thấy các cài đặt Aider quan trọng với model miễn phí: định dạng chỉnh sửa, model yếu và kích thước bản đồ kho.

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.

Bước 1: Cài đặt FreeLLMAPI

FreeLLMAPI là cổng mã nguồn mở. Nó chạy trên máy tính của bạn trong Docker. Nó gom các gói miễn phí của 45 nhà cung cấp sau một khóa tương thích OpenAI.

Cài đặt trên macOS hoặc Linux

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

Mở http://localhost:3001. Thêm ít nhất hai khóa nhà cung cấp miễn phí ở trang Keys. Sao chép khóa thống nhất của bạn từ cùng trang.

Bước 2: Kết nối Aider

Lệnh thiết lập ghi ~/.aider.conf.yml. Trước tiên, nó sao lưu tệp hiện có.

Một lệnh

npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-aider --url http://localhost:3001 --api-key <unified-key>
aider

Tệp mà lệnh ghi ra trông như sau:

~/.aider.conf.yml

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"

Tiền tố openai/ là bắt buộc. Nó bảo Aider gửi tên model tới một API tương thích OpenAI. Để dùng biến môi trường và không dùng tệp, làm như sau:

Chỉ dùng biến môi trường

export OPENAI_API_BASE=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
aider --model openai/auto

Aider tìm .aider.conf.yml trong thư mục home, sau đó ở gốc kho git, rồi ở thư mục hiện tại. Tệp được tải sau cùng có độ ưu tiên cao nhất. Do đó, một tệp của dự án có thể đổi model cho một kho.

Bước 3: Chọn model

Aider gửi tệp của bạn và bản đồ kho trong mỗi yêu cầu. Nó không cần gọi công cụ cho vòng lặp chỉnh sửa chính, vì nó đọc các chỉnh sửa từ văn bản của model. Cửa sổ ngữ cảnh lớn và khả năng làm theo chỉ dẫn tốt quan trọng hơn. Bảng hiển thị các model miễn phí có ít nhất 128K ngữ cảnh hiện nay.

Model miễn phí cho Aider: ngữ cảnh 128K trở lên, theo trí tuệ
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.3APINex, UnoRouter1M5 yêu cầu/phút
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
CóKhông
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 nữa1M40 yêu cầu/phút
40 RPM
CóCó
Gemini 3.8 FlashAPINex, Google AI Studio1M5 yêu cầu/phút
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
CóCó
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceCóKhông
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditCóCó
Deepseek V4.1 FlashAPINex1M5 yêu cầu/phút
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
KhôngKhông
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
DeepSeek V4 Flash 0731ElectronHub, Router91M10,000 credits/month (~$1), shared; account-anniversary resetKhôngKhông
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 nữa262K30 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ị 12 trong số 184 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.

Dùng openai/auto để bộ định tuyến chọn model. Dùng openai/auto:smart để ưu tiên các model có trí tuệ cao nhất. Để ghim một model, dùng openai/ và một ID trong danh mục từ GET /v1/models.

Bạn cũng có thể đặt model cho một phiên trên dòng lệnh. Ví dụ này dùng các model mạnh nhất để chỉnh sửa. Nó dùng model nhanh cho thông điệp commit và tóm tắt lịch sử trò chuyện:

Model cho một phiên

aider --model openai/auto:smart --weak-model openai/auto:fast

Với một hồ sơ đã lên kế hoạch, tạo một chuỗi dự phòng trên bảng điều khiển FreeLLMAPI, ví dụ một chuỗi tên coding. Sau đó dùng --model openai/auto:coding. Tên hồ sơ không tồn tại sẽ trả về lỗi 400, nên yêu cầu không chuyển sang chuỗi khác mà bạn không biết.

Cài đặt Aider cho model miễn phí

Aider biết cài đặt của các model phổ biến. Một model cổng như auto thì không được biết, nên bạn tự đặt các giá trị này.

Cài đặtTác dụngGiá trị khuyến nghị cho model miễn phí
edit-formatĐịnh dạng model dùng để gửi chỉnh sửa: whole, diff, diff-fenced hoặc udiffdiff cho model mạnh. whole cho model yếu, vì nó đơn giản hơn nhưng gửi nhiều token hơn.
weak-modelModel dùng cho thông điệp commit và tóm tắt lịch sử trò chuyệnopenai/auto:fast, để tác vụ nhỏ không dùng hạn mức của model mạnh
map-tokensSố token cho bản đồ kho. 0 tắt nó.1024 hoặc thấp hơn trên gói miễn phí nhỏ
architectMột model lên kế hoạch thay đổi, và một model biên tập viết các chỉnh sửaTùy chọn. Nó làm tăng gấp đôi số yêu cầu.

~/.aider.conf.yml với cài đặt cho model miễn phí

openai-api-base: "http://localhost:3001/v1"
openai-api-key: "<unified-key>"
model: "openai/auto"
weak-model: "openai/auto:fast"
edit-format: diff
map-tokens: 1024

Để cho Aider biết cửa sổ ngữ cảnh của một model cổng, thêm tệp .aider.model.metadata.json. Khóa là tên model đầy đủ. Aider tìm tệp này ở cùng các vị trí với tệp cấu hình.

~/.aider.model.metadata.json

{
  "openai/auto": {
    "max_input_tokens": 128000,
    "max_output_tokens": 8192,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Giới hạn tốc độ và chuyển dự phòng

Gói miễn phí có giới hạn mỗi phút và mỗi ngày. FreeLLMAPI đếm mức dùng của từng khóa. Khi một nhà cung cấp gửi lỗi 429, bộ định tuyến gửi yêu cầu tới model tiếp theo trong chuỗi của bạn. Aider không thấy lỗi và tiếp tục.

  • Thêm khóa từ bốn nhà cung cấp trở lên. Nhiều nhà cung cấp hơn cho nhiều yêu cầu hơn mỗi ngày.
  • Chỉ thêm các tệp bạn muốn thay đổi bằng /add. Mỗi tệp nằm trong mọi yêu cầu.
  • Dùng /clear giữa các tác vụ để gửi lịch sử trò chuyện ngắn hơn. Lịch sử ngắn cũng làm giảm token mỗi phút.
  • Dùng /drop để xóa các tệp bạn không cần nữa.

Khắc phục sự cố

Vấn đềNguyên nhânCách khắc phục
"Model openai/auto: Kích thước cửa sổ ngữ cảnh và chi phí không rõ, dùng giá trị mặc định hợp lý."Aider không biết model cổngCảnh báo này thường vô hại. Để bỏ nó, thêm .aider.model.metadata.json.
Chỉnh sửa không được áp dụngModel không làm theo định dạng chỉnh sửaDùng --edit-format whole, hoặc một model mạnh hơn
401 "Invalid API key"Aider gửi khóa khác, ví dụ từ một tệp cấu hình khácKiểm tra các tệp cấu hình trong thư mục home, gốc git và thư mục hiện tại
Aider gọi api.openai.comĐã dùng tiền tố openai/, nhưng chưa đặt base URLĐặt openai-api-base hoặc OPENAI_API_BASE
"Tất cả model bị giới hạn tốc độ sau N lần thử"Mọi khóa đều đạt giới hạnThêm khóa từ nhiều nhà cung cấp hơn, hoặc giảm map-tokens
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 Aider miễn phí không?

Có. Aider là mã nguồn mở. Trỏ nó tới FreeLLMAPI bằng openai-api-base và tiền tố model openai/. Cổng dùng các gói miễn phí của nhà cung cấp, nên chi phí suy luận là $0.

Làm sao để dùng Aider với API tương thích OpenAI?

Đặt OPENAI_API_BASE và OPENAI_API_KEY, rồi chạy aider --model openai/. Tiền tố openai/ là bắt buộc. Bạn có thể đặt cùng giá trị trong .aider.conf.yml.

Tôi nên dùng định dạng chỉnh sửa nào với model miễn phí?

Dùng diff cho model mạnh, vì nó gửi ít token hơn. Nếu chỉnh sửa không áp dụng được, dùng whole. Nó đơn giản hơn cho model yếu nhưng gửi toàn bộ tệp mỗi lần.

'Unknown context window size and costs, using sane defaults' nghĩa là gì?

Aider không biết tên model, nên nó dùng giá trị mặc định. Cảnh báo này thường vô hại. Thêm .aider.model.metadata.json với cửa sổ ngữ cảnh để bỏ nó.

Model miễn phí nào tốt nhất cho Aider?

Dùng model có cửa sổ ngữ cảnh lớn và khả năng làm theo chỉ dẫn tốt. Bảng trong trang này cho thấy các model miễn phí mạnh nhất có từ 128K ngữ cảnh trở lên hiện nay.

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í