Junie CLI

Junie CLI nhận endpoint tùy chỉnh dưới dạng profile JSON trong $JUNIE_HOME/models/, trong đó baseUrl là URL endpoint đầy đủ và fasterModel quyết định nơi lưu lượng phụ trợ đi qua.

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép — khóa chỉ hiển thị một lần. Export khóa dưới dạng KUNAVO_API_KEY trong shell bạn sẽ dùng để khởi động Junie, hoặc ghi trực tiếp khóa vào tệp; JetBrains lưu ý rằng “Các giá trị không có tham chiếu ${...} nào sẽ được dùng nguyên trạng”.
2. Lưu JSON bên trên dưới dạng $JUNIE_HOME/models/kunavo.json cho tài khoản của bạn, hoặc .junie/models/kunavo.json để chia sẻ với một kho mã. Tên tệp bỏ phần .json sẽ trở thành profile id — nhờ vậy bộ chọn bên dưới hiển thị custom:kunavo.
3. Đặt id thành model id bạn thực sự muốn dùng. Tài liệu mô tả đây là “Định danh mô hình theo yêu cầu của endpoint API”, vì vậy có thể nhập trực tiếp slug Kunavo trong bảng bên dưới; ID được phân giải tại endpoint chứ không phải trong Junie.
4. Khởi động Junie rồi chọn hồ sơ: junie --model custom:kunavo, hoặc dùng lệnh /model trong phiên tương tác. “Các mô hình tùy chỉnh xuất hiện trong danh sách chọn mô hình sau các nhà cung cấp tích hợp sẵn”.
5. Giao cho Junie một tác vụ chỉnh sửa tệp thay vì chỉ chào hỏi. Junie là ứng dụng khách dạng agent và dựa vào việc gọi công cụ cho hầu hết mọi thao tác, nên lần chạy đầu tiên đọc và ghi một thứ gì đó sẽ cho bạn biết nhiều hơn một phản hồi đơn lẻ.

Đã kiểm tra đối chiếu với Trang Custom LLMs của JetBrains dành cho Junie 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 Junie CLI.

# 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.

Hai giá trị apiType còn lại mà Kunavo hỗ trợ

apiType chỉ định định dạng yêu cầu, không phải nhà cung cấp; Junie chấp nhận bốn giá trị: OpenAICompletion, OpenAIResponses, Google và Anthropic. Kunavo cung cấp ba tuyến, nên hai trong số ba giá trị còn lại có tuyến baseUrl tương ứng — và vì Junie không nối thêm đường dẫn nào, đổi định dạng cũng đồng nghĩa phải đổi URL trong cùng lần chỉnh sửa:

1. "apiType": "OpenAICompletion" với https://api.kunavo.com/v1/chat/completions — hồ sơ bên trên và lựa chọn được trang này đề xuất vì đây là tuyến được sử dụng rộng rãi nhất trong ba tuyến.
2. "apiType": "Anthropic" với https://api.kunavo.com/v1/messages — Kunavo hỗ trợ định dạng Messages tại đường dẫn đó.
3. "apiType": "OpenAIResponses" với https://api.kunavo.com/v1/responses.

Xác định trong ba cách Junie hoạt động, cách nào phù hợp nhất với từng mô hình là câu hỏi cần thử nghiệm khi chạy, không thể trả lời chỉ bằng cách đọc tài liệu; vì vậy trang này không xếp hạng chúng ngoài lựa chọn nêu ở dòng đầu. Hãy chọn một cách, giữ URL và apiType đồng bộ; nếu hồ sơ dùng khóa trả về lỗi 401, hãy chỉ định thông tin xác thực rõ ràng thay vì đoán header của Junie: JetBrains chỉ mô tả apiKey theo hướng phủ định — “Nếu bị lược bỏ, yêu cầu sẽ được gửi mà không có header Authorization” — và không bao giờ nêu cách thức được dùng khi có khai báo. extraHeaders được mô tả là “các header HTTP bổ sung cần đưa vào mọi yêu cầu” và chấp nhận cùng kiểu tham chiếu ${VAR}, vì vậy dùng "extraHeaders": {"Authorization": "Bearer ${KUNAVO_API_KEY}"} là cách khai báo tường minh nhất.