Skip to Content
aicentos

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ườngGiá trị
base_urlhttps://aicentos.com/v1
api_backendchat_completions (giá trị mặc định)
env_keyAICENTOS_API_KEY
modelmodel 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 ~/.zshrc hoặc ~/.bashrc rồi source để 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.7 và 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 models

Rồ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_backend mặc định đã là chat_completions; nếu ghi rõ thành responses hoặc messages, 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_key trong cấu hình mô hình → biến môi trường do env_key chỉ định → token phiên đã đăng nhập → XAI_API_KEY toàn cục. Ở đây dùng env_key tham 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ư.