Grok Build
Kết nối aicentos trong Grok Build —— tự định nghĩa model provider qua config.toml
Cập nhật lần cuối:
Grok Build là terminal coding Agent của xAI, mặc định gọi giao diện chính thức của xAI, nhưng nó hỗ trợ khai báo endpoint OpenAI tương thích bất kỳ dạng [model.*] trong ~/.grok/config.toml. Trỏ endpoint về aicentos, là có thể dùng cùng một Key gọi các mô hình dòng grok và các mô hình của nhà cung cấp khác.
Chuẩn bị
-
Cài Grok Build (script chính thức):
curl -fsSL https://x.ai/cli/install.sh | bash -
Tạo một Key chuyên dụng trong Console của aicentos (khuyến nghị đặt tên
grok-build).
Cấu hình cần điền
| Trường | Giá trị |
|---|---|
| base_url | https://aicentos.com/v1 |
| api_backend | chat_completions (giá trị mặc định) |
| env_key | AICENTOS_API_KEY |
| model | model ID trong "Model Square" của Console, ví dụ grok-4.7, claude-opus-4-8 |
| context_window | điền theo mô hình đã chọn, ví dụ 200000 |
Các bước thiết lập
-
Ghi Key vào biến môi trường shell (ghi vào
~/.zshrchoặc~/.bashrcrồisourceđể có hiệu lực):export AICENTOS_API_KEY="your_api_key_here" -
Sửa
~/.grok/config.toml, thêm một mô hình tùy chỉnh:[models] default = "aicentos-grok" [model.aicentos-grok] base_url = "https://aicentos.com/v1" env_key = "AICENTOS_API_KEY" api_backend = "chat_completions" context_window = 200000 max_completion_tokens = 8192 description = "aicentos gateway - grok-4.7"<name>trong[model.<name>]chính là model ID; nếu muốn kết nối nhiều mô hình, ví dụgrok-4.7vàclaude-opus-4-8, thì lần lượt viết thêm một đoạn[model.grok-4.7],[model.claude-opus-4-8]. -
Khởi động Grok Build, dùng bộ chọn mô hình hoặc lệnh để chuyển:
grok /model aicentos-grok
Kiểm tra
Trước tiên liệt kê xem mô hình có được nhận diện không:
grok modelsRồi gửi một câu prompt nhẹ (ví dụ grok -p "giới thiệu thư mục hiện tại trong một câu" -m aicentos-grok) xác nhận có thể trả về bình thường.
Lưu ý
- Grok Build không có tham số dòng lệnh
--base-url, endpoint tùy chỉnh chỉ có thể chỉ định qua file cấu hình hoặc biến môi trường. api_backendmặc định đã làchat_completions; nếu ghi rõ thànhresponseshoặcmessages, cần xác nhận gateway hỗ trợ endpoint tương ứng, nếu không sẽ thất bại.- Thứ tự phân giải thông tin xác thực:
api_keytrong cấu hình mô hình → biến môi trường doenv_keychỉ định → token phiên đã đăng nhập →XAI_API_KEYtoàn cục. Ở đây dùngenv_keytham chiếu tên biến của bạn là được, sẽ không lẫn sang tài khoản chính thức của xAI. - Nếu mô hình thêm mới bỏ qua
context_window, Grok Build mặc định xử lý theo 200,000; khuyến nghị điền rõ theo mô hình đã chọn. - Sau khi nối endpoint tùy chỉnh sẽ không còn phụ thuộc gói đăng ký xAI, nhưng mô hình được chọn vẫn do phía aicentos tính phí, trước tiên vào trang Ví xác nhận số dư.