Thiết lập API cho Droid: Cách kết nối mô hình AI tùy chỉnh

Droid hỗ trợ cả mô hình AI tích hợp sẵn lẫn mô hình bên ngoài, giúp bạn linh hoạt hơn khi làm việc với các tác vụ lập trình. Hướng dẫn này sẽ chỉ cho bạn cách kết nối một API bên ngoài, cấu hình thiết lập, khắc phục các sự cố thường gặp và sử dụng Kimi để hỗ trợ phát triển phần mềm bằng AI. Lưu ý: Hướng dẫn này chỉ áp dụng cho Droid CLI. Các mô hình tùy chỉnh hiện chỉ được hỗ trợ trên CLI và chưa khả dụng trên các sản phẩm Droid khác.

Kết nối Droid với Kimi API

10 phút đọc2026-08-12

Muốn dùng mô hình AI của riêng bạn để lập trình mà không cần thiết lập phức tạp? Droid giúp việc này dễ dàng hơn nhờ hỗ trợ API bên ngoài trong CLI, cho phép bạn kết nối một mô hình tùy chỉnh phù hợp với quy trình làm việc của mình. Hướng dẫn này sẽ chỉ cho bạn cách thiết lập API, khắc phục các sự cố thường gặp và sử dụng Kimi trong Droid. Hãy đọc tiếp để bắt đầu.

Droid là gì?

Droid là một công cụ lập trình AI giúp lập trình viên viết code, xử lý lỗi và thực hiện các tác vụ phát triển phần mềm hiệu quả hơn. Nó hỗ trợ các mô hình AI tích hợp sẵn và cũng cho phép người dùng kết nối các mô hình tùy chỉnh thông qua CLI để linh hoạt hơn. Điều này khiến Droid hữu ích cho nhiều quy trình lập trình khác nhau, dù bạn cần hỗ trợ nhanh hay một thiết lập được cá nhân hóa hơn.

Cách sử dụng mô hình AI tích hợp sẵn trong Droid?

Mô hình AI tích hợp sẵn giúp bạn dễ dàng bắt đầu lập trình với Droid vì không cần kết nối với bất kỳ API bên ngoài nào trước. Sau khi cài đặt ứng dụng, bạn có thể chọn một mô hình ngay trong nền tảng và bắt đầu sử dụng hỗ trợ AI để phân tích code, phát triển tính năng, sửa lỗi và đánh giá code. Dưới đây là cách bắt đầu với Droid:

Bước 1: Cài đặt và mở Droid

Bắt đầu bằng cách tải Factory App về thiết bị của bạn và hoàn tất cài đặt. Sau đó, mở ứng dụng và đăng nhập vào tài khoản của bạn. Điều này giúp bạn truy cập được Droid cùng các tính năng AI tích hợp sẵn trong ứng dụng.

Bước 2: Kết nối Droid với thư mục dự án của bạn

Đặt thư mục làm việc của bạn thành mã nguồn bạn muốn xử lý. Việc này liên kết Droid với dự án cục bộ của bạn để nó có thể đọc các tệp, hiểu cấu trúc code và hỗ trợ các tác vụ phát triển của bạn với ngữ cảnh tốt hơn.

Bước 3: Chọn một mô hình tích hợp sẵn và bắt đầu nhập prompt

Mở bộ chọn mô hình và chọn một trong các mô hình AI tích hợp sẵn có trong Droid. Sau khi chọn mô hình, bạn có thể bắt đầu đưa ra các prompt như yêu cầu phân tích mã nguồn, sửa lỗi, đánh giá code, hoặc xây dựng một tính năng.

Cách kết nối Droid với một API bên ngoài?

Kết nối Droid với một API bên ngoài giúp bạn tự do hơn khi làm việc với mô hình mà bạn ưa thích, thay vì chỉ giới hạn ở các tùy chọn tích hợp sẵn. Việc thiết lập diễn ra bên trong Droid CLI bằng cách thêm một mô hình tùy chỉnh vào tệp cài đặt, và sau khi lưu, mô hình sẽ xuất hiện trong menu /model. Các bước dưới đây sử dụng Kimi làm ví dụ đơn giản, để bạn có thể thấy toàn bộ quá trình thiết lập diễn ra như thế nào, từ API key đến việc chọn mô hình:

Bước 1: Lấy Kimi API key từ Moonshot AI

Bắt đầu bằng cách tạo hoặc sao chép Kimi API key từ Moonshot AI. Bạn sẽ cần key này vì Droid dùng nó để kết nối với Kimi API và gửi yêu cầu thông qua tài khoản của bạn. Tốt nhất nên lưu key dưới dạng biến môi trường như MOONSHOT_API_KEY để có thể sử dụng an toàn bên trong file settings.

Bước 2: Mở file settings của Droid

Tiếp theo, mở file settings nơi các model tùy chỉnh được thêm vào trong Droid CLI. Trên macOS, đường dẫn file là ~/.factory/settings.json. Trên Windows PowerShell, dùng %USERPROFILE%\.factory\settings.json. Đây là file chính mà Droid đọc để lấy cấu hình model tùy chỉnh của bạn.

Bước 3: Thêm Kimi làm model tùy chỉnh

Trong settings.json, thêm Kimi vào mảng customModels. Việc này cho Droid biết nên dùng model nào, gọi đến API endpoint nào, theo định dạng provider nào, và dùng API key nào để xác thực. Nếu file đã có các thiết lập khác, đừng thay thế toàn bộ, chỉ cần thêm object model này vào bên trong mảng customModels hiện có.

```json { "customModels": [ { "model": "kimi-k3", "displayName": "Kimi K3", "baseUrl": "https://api.moonshot.ai/v1", "apiKey": "${MOONSHOT_API_KEY}", "provider": "generic-chat-completion-api", "maxOutputTokens": 16384 } ] } ```

Bước 4: Lưu file và khởi động lại Droid

Sau khi thêm cấu hình, lưu file và khởi động lại Droid CLI. Việc này đảm bảo Droid nạp lại settings đã cập nhật và nhận diện đúng model tùy chỉnh vừa được thêm vào.

Bước 5: Chọn model Kimi bằng lệnh /model trong Droid

Mở Droid CLI và chạy lệnh /model. Cấu hình Kimi của bạn giờ sẽ xuất hiện trong mục Custom models. Chọn nó từ danh sách để đặt Kimi làm model đang hoạt động cho phiên lập trình của bạn.

Bước 6: Chạy một tác vụ

Khi đã chọn Kimi, bạn có thể bắt đầu dùng nó cho công việc thực tế trong Droid. Hãy thử một prompt như review code, sửa lỗi, hoặc giải thích một codebase. Droid sẽ gửi yêu cầu qua Kimi API và dùng model đó cho tác vụ.

Lợi ích của việc dùng Kimi API

Sau khi kết nối Kimi với Droid, nó không còn chỉ là một model bên ngoài trong CLI nữa. Nó trở thành một trợ lý lập trình thiết thực, phù hợp với quy trình phát triển hàng ngày và hỗ trợ cả những công việc lập trình nhỏ lẫn các tác vụ kỹ thuật lớn hơn. Dưới đây là một số lợi ích của việc dùng Kimi API:

Tăng hiệu quả phát triển

Kimi có thể giúp bạn xử lý các tác vụ lập trình hàng ngày nhanh hơn bằng cách tạo code, giải thích logic, và gợi ý cách sửa lỗi trong khi bạn làm việc. Điều này có nghĩa là bạn không cần chuyển qua lại giữa nhiều công cụ chỉ để có được hỗ trợ phát triển đơn giản. Với Kimi bên trong Droid, các công việc lập trình thường ngày trở nên dễ quản lý hơn.

Viết code đáng tin cậy hơn

Kimi có thể review code của bạn, chỉ ra các vấn đề có thể xảy ra, và giúp cải thiện cấu trúc trước khi những lỗi nhỏ trở thành vấn đề lớn hơn. Loại phản hồi sớm này rất hữu ích khi bạn muốn có logic gọn gàng hơn và khả năng bảo trì tốt hơn. Theo thời gian, nó có thể giúp bạn xây dựng code dễ kiểm thử, dễ cập nhật, và dễ hiểu hơn.

Xử lý đa dạng các tác vụ phát triển

Kimi không chỉ giới hạn ở việc viết code từ đầu. Nó còn có thể hỗ trợ tái cấu trúc code, viết tài liệu, tìm hiểu các dự án chưa quen thuộc, và hỗ trợ phát triển tính năng trong nhiều loại tác vụ khác nhau. Điều này khiến nó trở thành một lựa chọn linh hoạt cho các nhà phát triển muốn dùng một model AI duy nhất để hỗ trợ nhiều phần của quy trình làm việc.

Khắc phục các lỗi thường gặp khi kết nối API

Việc kết nối một API key bên ngoài trong Droid thường khá đơn giản, nhưng những sai sót nhỏ trong thiết lập vẫn có thể gây ra vấn đề. Hầu hết các lỗi đến từ file settings, tên provider, API key, hoặc cấu hình model server chứ không phải từ bản thân Droid. Điểm tốt là những lỗi này thường dễ khắc phục một khi bạn biết cần tìm ở đâu.

Model không xuất hiện trong bộ chọn

Kiểm tra cú pháp JSON trong ~/.factory/settings.json hoặc config.json nếu bạn đang dùng định dạng cũ
Các thay đổi trong settings được phát hiện tự động thông qua việc theo dõi file
Xác minh rằng tất cả các trường bắt buộc đều có mặt trong cấu hình model tùy chỉnh

Lỗi "Invalid provider"

Đảm bảo giá trị provider chính xác là anthropic, openai, hoặc generic-chat-completion-api
Kiểm tra lỗi chính tả và viết hoa đúng trong trường provider

Lỗi xác thực

Kiểm tra xem API key của bạn có hợp lệ và còn hạn mức sử dụng không
Kiểm tra xem API key có đủ quyền phù hợp với nhà cung cấp hay không
Xác nhận rằng base URL khớp với endpoint API trong tài liệu của nhà cung cấp

Model cục bộ không kết nối được

Đảm bảo máy chủ model cục bộ của bạn đang chạy, ví dụ như ollama serve
Kiểm tra xem base URL có chính xác và có bao gồm /v1/ nếu nhà cung cấp yêu cầu hay không
Kiểm tra xem model đã được tải về hoặc có sẵn ở máy cục bộ hay chưa

Lỗi giới hạn tốc độ hoặc hạn mức

Kiểm tra giới hạn tốc độ API và hạn mức sử dụng của nhà cung cấp bạn đang dùng
Theo dõi mức sử dụng từ bảng điều khiển của nhà cung cấp để xem đã chạm giới hạn hay chưa

Kết luận

Sử dụng API tùy chỉnh trong Droid giúp bạn kiểm soát tốt hơn cách xây dựng, kiểm thử và cải thiện code bằng AI. Sau khi thiết lập xong, việc định hình quy trình lập trình theo model phù hợp với nhu cầu của bạn sẽ trở nên dễ dàng hơn. Dù bạn tiếp tục dùng các tùy chọn có sẵn hay kết nối một model bên ngoài, Droid vẫn mang lại cách linh hoạt để đưa AI vào quá trình phát triển. Nếu bạn muốn có một điểm khởi đầu đơn giản với thiết lập tùy chỉnh, Kimi là lựa chọn đáng thử trong Droid. Đây có thể là một lựa chọn thực tế giúp công việc lập trình hàng ngày trở nên mượt mà và nhanh hơn.

Kết nối Droid với Kimi API

Câu hỏi thường gặp

Droid hỗ trợ những mô hình AI nào?

Droid hỗ trợ cả mô hình AI tích hợp sẵn lẫn mô hình tùy chỉnh được thêm vào qua CLI. Việc thiết lập bên ngoài hoạt động với các loại nhà cung cấp như Anthropic, OpenAI và các API chat-completion dạng chung. Điều này giúp người dùng linh hoạt làm việc với các API chính thức, một số nhà cung cấp mã nguồn mở, hoặc mô hình cục bộ tùy theo thiết lập của họ.

Cần thông tin gì để cấu hình một API bên ngoài?

Để cấu hình một API bên ngoài trong Droid, bạn thường cần mã mô hình, tên hiển thị, URL gốc, API key và loại nhà cung cấp. Một số thiết lập cũng có thể bao gồm các trường tùy chọn như số token đầu ra tối đa, tham số bổ sung hoặc header bổ sung. Những thông tin này giúp Droid kết nối chính xác với mô hình.

Tôi có thể chuyển đổi giữa mô hình AI tích hợp sẵn và mô hình bên ngoài không?

Có, Droid cho phép bạn chuyển đổi giữa mô hình tích hợp sẵn và mô hình bên ngoài. Mô hình tích hợp sẵn có thể chọn ngay trong ứng dụng, còn mô hình tùy chỉnh có thể chọn từ menu /model trong CLI sau khi thiết lập. Nhờ đó, bạn dễ dàng dùng các mô hình khác nhau cho từng tác vụ lập trình khác nhau.

Vì sao tôi gặp lỗi giới hạn tốc độ hoặc hạn mức?

Điều này thường có nghĩa là nhà cung cấp API của bạn đã đạt đến giới hạn sử dụng, giới hạn số lượng yêu cầu, hoặc hạn mức thanh toán. Hãy kiểm tra bảng điều khiển của nhà cung cấp để xem lại số credit, mức sử dụng và giới hạn tốc độ. Sau khi vấn đề giới hạn được giải quyết, mô hình sẽ hoạt động lại bình thường trong Droid mà không cần thay đổi thêm cấu hình nào.

Có thể bạn cũng sẽ thích