twinny

twinny không có trường base URL — Add provider → OpenAI-compatible server, sau đó Protocol https, Hostname api.kunavo.com, Port để trống và API path /v1, rồi chat panel sử dụng key của bạn.

Label          Kunavo
Type           Chat
Provider       OpenAI-compatible server
Hostname       api.kunavo.com
Port           (leave blank — "Blank means the protocol's default")
Protocol       https
API path       /v1
Model name     claude-sonnet-5
FIM template   (Autocomplete only — not part of a Chat provider)
API key        sk-kn-...

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Mở thẻ Providers từ biểu tượng robot ở đầu thanh bên, hoặc chạy lệnh Manage twinny providers từ bảng lệnh.
3. Add provider → trong mục On your machine, chọn OpenAI-compatible server, cấu hình sẵn tổng quát. Cấu hình này mặc định trỏ đến localhost:8080.
4. Đặt Protocol thành https, đặt Tên máy chủ thành api.kunavo.com, xóa nội dung trong Cổng và đặt Đường dẫn API thành /v1. Giữ nguyên Loại ở Chat.
5. Dán key vào API key — twinny gửi key dưới dạng Authorization: Bearer. Sau đó đặt Tên model, bằng cách nhập hoặc dùng Chọn từ các model của máy chủ, vì Kunavo hỗ trợ GET /v1/models.
6. Nhấn Test provider, rồi nhấn Use this provider để đặt làm nhà cung cấp trò chuyện đang hoạt động. Dùng Copy để sao chép hàng cấu hình cho model thứ hai thay vì nhập lại bốn trường endpoint.

Đã kiểm tra đối chiếu với trang Other local servers của twinny 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 twinny.

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

Trò chuyện hoạt động. Tự động hoàn thành và chỉ mục thì không.

twinny phân chia công việc giữa ba loại nhà cung cấp, mỗi loại được cấu hình riêng — vì vậy câu “twinny hoạt động với Kunavo” chỉ đúng với một loại. Hai loại còn lại không phải là cấu hình bạn chưa tìm ra; các route mà chúng cần không được Kunavo hỗ trợ.

Cả hai hạn chế đều không ngăn cản việc thiết lập, vì twinny chỉ giữ một nhà cung cấp đang hoạt động cho mỗi loại và chúng độc lập với nhau. Trang API lưu trữ của twinny gọi cách kết hợp này là “cấu hình phổ biến”: một model base nhỏ chạy cục bộ để hoàn thành, cùng với một model lưu trữ để trò chuyện, đánh giá và chỉnh sửa. Chỉ mục workspace cũng tương tự — bước embedding không được cung cấp ở đây, và tài liệu của twinny hướng dẫn dùng model cục bộ như nomic-embed-text trên Ollama để thay thế. Các vector từ những model khác nhau không thể kết hợp, vì vậy đổi model đó đồng nghĩa phải tạo lại chỉ mục thay vì cập nhật.