Crush

Cấu hình của Crush là Bash — một lệnh `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` trong crushrc đưa agent terminal của Charm chạy Claude và GPT.

# A crushrc is Bash, not a settings file. Everything here is executed.
provider add kunavo \
  --type openai-compat \
  --base-url "https://api.kunavo.com/v1" \
  --api-key "${KUNAVO_API_KEY:?set KUNAVO_API_KEY}"

model add kunavo/claude-sonnet-5 \
  --name "Claude Sonnet 5" \
  --context-window 1000000 \
  --default-max-tokens 32000 \
  --price-input 1.4 \
  --price-output 7

model add kunavo/claude-haiku-4-5 \
  --name "Claude Haiku 4.5" \
  --context-window 200000 \
  --default-max-tokens 16000 \
  --price-input 0.7 \
  --price-output 3.5

model large kunavo/claude-sonnet-5
model small kunavo/claude-haiku-4-5

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ được hiển thị một lần. Export khóa thành KUNAVO_API_KEY, hoặc đọc khóa từ trình quản lý mật khẩu ngay trong cấu hình.
2. Đặt khối bên trên vào ~/.config/crush/crushrc. Crush đọc ./.crushrc, rồi ./crushrc, rồi đến cấu hình toàn cục, vì vậy một dự án có thể ghi đè cấu hình của máy — và một kho mã bạn đã clone có thể chứa tệp này.
3. Khởi chạy crush rồi nhấn ctrl+l để mở bộ chọn model. Các dòng model large và model small ở trên đã ghim sẵn cả hai vị trí, nên bộ chọn dùng để chuyển đổi chứ không phải để thiết lập.
4. Nếu không muốn đăng ký id thủ công: tính năng tự động phát hiện chạy khi danh sách model của nhà cung cấp openai-compat trống hoặc khi bạn truyền --discover-models true. Kunavo phản hồi tại GET /v1/models, vì vậy danh sách sẽ tự điền; các trường model add do bạn tự cấu hình sẽ được ưu tiên khi có xung đột.
5. Chạy một tác vụ có phạm vi giới hạn, rồi xem khoản phí tài khoản ghi nhận tại /app/billing. Con số trong terminal chỉ là phép tính dựa trên các giá trị --price-* bạn đã nhập; sổ giao dịch mới là hóa đơn.

Đã kiểm tra đối chiếu với Mục Nhà cung cấp tùy chỉnh của Crush vào 21 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Crush.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.