Aider

Aider kết nối với các API tương thích OpenAI qua tiền tố mô hình openai/: trỏ Base URL và key tới cheapaimodel, rồi thêm openai/ trước ID mô hình.

Thiết lập

python -m pip install aider-install
aider-install

Sau đó, trong dự án của bạn:

export OPENAI_API_BASE="https://api.cheapaimodel.ai/v1"
export OPENAI_API_KEY="$CHEAPAIMODEL_API_KEY"
aider --model openai/glm-5.3

Aider bỏ tiền tố đi và gửi yêu cầu glm-5.3 tới /v1/chat/completions.

Để lưu lại cài đặt mà không phải export các biến OPENAI_* cho mọi công cụ, đặt các cài đặt này trong tệp cấu hình của Aider:

model: openai/glm-5.3
openai-api-base: https://api.cheapaimodel.ai/v1
openai-api-key: sk-...

Aider cũng đọc .aider.conf.yml ở thư mục gốc của repo git. Đừng commit các tệp chứa key lên repo.

Cảnh báo về mô hình

Khi khởi động, Aider in ra Unknown context window size and costs, using sane defaults với những mô hình mà Aider không có metadata, và có thể gợi ý tên tương tự như zai/glm-5.3. Giữ nguyên openai/glm-5.3: các tên được gợi ý gọi thẳng nhà cung cấp khác, không qua cheapaimodel. Theo tài liệu của Aider, có thể bỏ qua cảnh báo này vì Aider không áp giới hạn token.

Để tắt cảnh báo, truyền --no-show-model-warnings, hoặc mô tả mô hình trong .aider.model.metadata.json ở thư mục home của bạn:

{
  "openai/glm-5.3": {
    "max_input_tokens": CONTEXT_LENGTH,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Thay CONTEXT_LENGTH bằng độ dài ngữ cảnh ghi trên trang của mô hình, ví dụ glm-5.3. Aider không biết giá của cheapaimodel; xem chi tiêu của bạn ở trang Hoạt động trong bảng điều khiển.

Lỗi thường gặp

• litellm.BadRequestError: LLM Provider NOT provided. ID mô hình thiếu tiền tố openai/. Dùng --model openai/glm-5.3.
• Aider khởi động với gpt-4o và mọi yêu cầu đều báo lỗi. Nếu không có --model (hoặc model: trong tệp cấu hình), Aider thấy OPENAI_API_KEY và chọn một mô hình OpenAI mặc định, chẳng hạn gpt-4o với gpt-4o-mini làm weak model. Chúng tôi không cung cấp các ID đó. Luôn chỉ định mô hình.
• Yêu cầu của --weak-model hoặc --editor-model báo lỗi. Hai tùy chọn này theo cùng quy tắc với --model: thêm tiền tố openai/ và dùng ID trong danh mục, ví dụ --weak-model openai/glm-5.3-flash. Nếu bạn không đặt cái nào, Aider dùng mô hình chính cho cả hai.
• "The API provider's servers are down or overloaded", kèm các lần thử lại. Aider báo mọi lỗi 503 theo cách này. Nếu lỗi ngay từ yêu cầu đầu tiên, kiểm tra ID mô hình: ID mà chúng tôi không cung cấp sẽ trả về 503 kèm model_not_found. Các trường hợp khác, xem Lỗi.
• fault filter abort hoặc Invalid URL (POST /v1/chat/completions/chat/completions). Cả hai đều là 404 do Base URL sai: lỗi thứ nhất nghĩa là thiếu /v1, lỗi thứ hai nghĩa là Base URL có kèm đường dẫn endpoint. Đặt chính xác https://api.cheapaimodel.ai/v1.