Nanocoder

Một mục Custom Provider trong nanocoder.providers của agents.config.json — name, baseUrl, apiKey, models — không cần dòng sdkProvider vì mặc định là openai-compatible.

{
  "nanocoder": {
    "providers": [
      {
        "name": "Kunavo",
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
      }
    ]
  }
}

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép — khóa chỉ được hiển thị một lần. Xuất khóa thành KUNAVO_API_KEY thay vì dán vào tệp: Nanocoder thay thế đệ quy $VAR, ${VAR} và ${VAR:-default} trong mọi chuỗi của mục nhà cung cấp, đồng thời đọc .env từ thư mục làm việc.
2. Chạy /settings providers trong Nanocoder rồi chọn Custom Provider. Trình hướng dẫn lần lượt yêu cầu nhập Provider name, Base URL, API key (optional), Model names và Request timeout, đồng thời đề nghị lấy danh sách mô hình từ endpoint — Kunavo phản hồi GET /v1/models, nên danh sách sẽ tự động được điền.
3. Hoặc bỏ qua trình hướng dẫn và tự viết agents.config.json bằng khối cấu hình ở trên. Lưu ý rằng các thiết lập được phân giải theo từng tệp: tệp cấp dự án định nghĩa nanocoder.providers sẽ cung cấp toàn bộ khối đó, nên các mục trong cấu hình toàn cục sẽ không được gộp vào.
4. Đặt cửa sổ ngữ cảnh. Nanocoder xác định giới hạn theo thứ tự /context-max, rồi contextWindows[model], contextWindow, NANOCODER_CONTEXT_LIMIT, cuối cùng là models.dev — Kunavo không phải nhà cung cấp trên models.dev, nên nếu không có một trong bốn giá trị đầu, hệ thống sẽ tính ngân sách dựa trên giá trị dự phòng không phải của mô hình bạn dùng. Các con số nằm tại /models.
5. Mở /model, chọn một trong các ID bạn đã liệt kê — bộ chọn hiển thị chúng dưới tên name mà bạn đã cung cấp — rồi chạy một tác vụ nhỏ cần gọi công cụ. Nếu lệnh gọi công cụ trả về dữ liệu sai định dạng trên một mô hình cụ thể, disableToolModels sẽ tắt tính năng đó riêng cho từng mô hình thay vì cho cả nhà cung cấp.

Đã kiểm tra đối chiếu với Trang Custom Provider của Nanocoder 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 Nanocoder.

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