aicentosAntigravity
Google Antigravity hiện chưa hỗ trợ Base URL tùy chỉnh —— giải thích giới hạn và các phương án thay thế khả dụng
Cập nhật lần cuối:
Antigravity là IDE agentic do Google ra mắt. Cần nói rõ một điểm trước: bản chính thức của Antigravity desktop IDE không hỗ trợ API endpoint tùy chỉnh, cũng không cung cấp BYOK (mang key theo), bộ chọn mô hình chỉ là một danh sách cố định do Google duy trì, hiện không thể trỏ về aicentos.
Bài viết này trình bày căn cứ của giới hạn này, cách xác minh, cùng ba đường thay thế khả dụng.
Vì sao không thể kết nối trực tiếp
Tài liệu về phương án tài khoản của Google nói rõ rằng Antigravity tạm chưa hỗ trợ tự mang mô hình hay tự mang endpoint. Một số mục cấu hình được truyền miệng trong cộng đồng (ví dụ ghi antigravity.ai.provider, antigravity.openai-compatible.endpoint vào ~/.antigravity/settings.json) không phải là key được hỗ trợ chính thức, kiểm nghiệm thực tế cho thấy yêu cầu không được định tuyến tới endpoint tùy chỉnh, hoặc lặng lẽ rơi về mô hình mặc định, và bộ chọn mô hình cũng không xuất hiện mục tùy chỉnh.
Nói cách khác, vấn đề này không phải là "cấu hình viết sai", mà là phiên bản hiện tại chưa mở khả năng này. Trong Settings → Models của IDE cũng không có trường Base URL nào để điền.
Cấu hình cần điền
| Trường | Giá trị |
|---|---|
| API Key | Key tạo trong Console |
| Base URL | https://aicentos.com/v1 |
| Mô hình | tên mô hình trong "Model Square" của Console |
Bảng trên là tham số chung phía aicentos, dùng cho bất kỳ phương án thay thế nào dưới đây.
Phương án thay thế
Phương án một: đổi sang Antigravity CLI (khuyến nghị, chỉ giới hạn giao thức Gemini)
Công cụ dòng lệnh cùng tên agy hỗ trợ ghi đè endpoint, có thể kết nối qua GOOGLE_GEMINI_BASE_URL + GEMINI_API_KEY, nhưng chỉ nhận giao thức Gemini, chỉ gọi được các mô hình dòng Gemini. Các bước cụ thể xem tại Kết nối Antigravity CLI.
Nếu nhu cầu của bạn là "dùng cách tương tác của Antigravity trong terminal", thì đây là đường tiết kiệm công nhất.
Phương án hai: đóng gói mô hình cục bộ hoặc dịch vụ bên thứ ba thành công cụ MCP
Bảng Customizations của Antigravity hỗ trợ đăng ký MCP Server. Có thể đóng gói dịch vụ cục bộ thành công cụ MCP rồi gắn vào, dùng như một công cụ có thể gọi. Cần lưu ý: điều này không thay thế mô hình suy luận của IDE, mà chỉ cho agent thêm một công cụ.
Phương án ba: nhánh cộng đồng hoặc proxy cục bộ
- Nhánh cộng đồng
open-antigravityhỗ trợ mọi endpoint tương thích OpenAI và mô hình tùy chỉnh, là đường "sạch" nhất ngoài bản chính thức. - Cũng có người dùng proxy chặn cục bộ để ghi đè lưu lượng đi ra của IDE. Đường này không có hỗ trợ chính thức, cấu hình mong manh, nâng cấp là mất tác dụng, không khuyến nghị dùng trong môi trường sản xuất.
Kiểm tra
Dù chọn đường nào, trước tiên hãy dùng một câu prompt đơn giản xác nhận kết nối thông, rồi mới chính thức đưa vào sử dụng. Với loại tác vụ agent, khuyến nghị chạy thử trước trên một repo nhỏ.
Lưu ý
- Đừng coi "mục cấu hình có vẻ tồn tại" thành "tính năng dùng được". Các key
antigravity.*trong IDE phần lớn là suy đoán của cộng đồng, ghi vào không báo lỗi nhưng cũng không có tác dụng. - Nếu bạn cần giao thức tương thích OpenAI, hoặc muốn gọi các mô hình dòng Claude / GPT, bản desktop Antigravity hiện chưa đáp ứng được, hãy ưu tiên cân nhắc các client hỗ trợ Base URL tùy chỉnh như Cursor, Windsurf.
- Antigravity CLI và desktop IDE là hai bộ cấu hình riêng biệt, việc ghi đè endpoint của CLI không ảnh hưởng tới IDE.
- Trước khi dùng bất kỳ nhánh bên thứ ba hay proxy nào, hãy tự đánh giá tính an toàn và tình hình bảo trì về sau của nó.