Hướng dẫn tích hợp agent
Dùng Aider với WaveSpeed LLM API
Hướng dẫn này chỉ cách kết nối Aider với WaveSpeed AI bằng ~/.aider.conf.yml, Chat completions tương thích OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 và model mặc định deepseek/deepseek-v4.1-flash-1017. Copy cấu hình phía trên, export API key, chạy agent, rồi kiểm tra request trong Logs.
Tạo access key WaveSpeed
Export key cần thiết ở máy local
Dán cấu hình vào
~/.aider.conf.ymlChạy aider và kiểm tra Logs
Setup Aider này cấu hình gì
Giao thức
Chat completions tương thích OpenAI
Endpoint
/v1/chat/completions
Model
deepseek/deepseek-v4.1-flash-1017
Cấu hình sẵn để copy ở trên là file Aider duy nhất bạn cần sửa cho setup được khuyến nghị: ~/.aider.conf.yml. Giữ API key trong môi trường shell để không commit vào repository.
Xử lý sự cố
API key không được nhận
Export WAVESPEED_API_KEY trong cùng shell nơi bạn chạy Aider. Nếu dùng shell profile, hãy reload terminal trước khi khởi động agent.
Request lỗi protocol hoặc endpoint
Kiểm tra Aider đang dùng Chat completions tương thích OpenAI và endpoint /v1/chat/completions. Sai protocol là nguyên nhân phổ biến nhất của lỗi 404 hoặc payload.
Model đã chọn không hoạt động
Xác nhận model id tồn tại trong WaveSpeed Models, rồi dán đúng id vào ~/.aider.conf.yml. Bạn có thể bắt đầu với model mặc định hiển thị trên trang này.
Không thấy request trong Logs
Đảm bảo Aider dùng WaveSpeed base URL và API key hiện tại của bạn. Sau đó gửi prompt mới từ agent local và refresh Logs.
Hướng dẫn Aider này có thể xuất hiện trên tìm kiếm không?
Có. Trang này được xây dựng như một hướng dẫn setup có thể index cho người dùng tìm kiếm Aider custom provider, endpoint tương thích OpenAI, base URL và workflow cấu hình agent local.