Tài liệu

Copilot cho Obsidian

Thẻ BYOK của Copilot nhận một nhà cung cấp tùy chỉnh tương thích OpenAI qua ba trường. Tài liệu nêu rõ các bề mặt nào có thể dùng những mô hình này; trang này giữ đúng mức độ chính xác đó thay vì hứa hẹn rằng toàn bộ plugin đều dùng được.

Settings → Copilot → BYOK → Add a custom provider: Display name, key của bạn và https://api.kunavo.com/v1 — Quick Chat luôn khả dụng, Agent Chat nằm dưới opencode khi nhà cung cấp được hiển thị ở đó.

Cài đặt → Copilot → BYOK → Thêm nhà cung cấp → Thêm nhà cung cấp tùy chỉnh

Display name             Kunavo
API key                  sk-kn-...
Base URL                 https://api.kunavo.com/v1
Enable CORS              off — see the note below before turning it on
Model ID → Add           claude-sonnet-5
                         claude-haiku-4-5
Search available models  discovery reads GET /v1/models; typed ids also work
Save                     needs at least one model and a routable endpoint

URL cơ sở ở đây giữ hậu tố /v1, và tài liệu xác định điều đó bằng ví dụ chứ không phải bằng một câu khẳng định: tài liệu chỉ nói rằng "Một nhà cung cấp tùy chỉnh tương thích OpenAI phải có URL cơ sở", nhưng cả hai mẫu tương thích OpenAI được cung cấp đều mặc định dùng URL kết thúc bằng /v1 — http://localhost:11434/v1 cho Ollama và http://localhost:1234/v1 cho LM Studio — đồng thời ghi thêm rằng "Việc khám phá mô hình sử dụng phản hồi /v1/models của endpoint". Nếu kết quả khám phá trống, đây là cặp thông tin đầu tiên cần kiểm tra lại.

Nhà cung cấp BYOK không dùng được ở mọi khu vực trong plugin, và tài liệu nói rõ điều đó: "Thêm khóa không làm thay đổi các mô hình do Claude Code hoặc Codex cung cấp." Bảng riêng của Copilot chỉ định rõ mô hình BYOK cho Quick Chat, còn Agent Chat chỉ dùng được với backend opencode, "khi nhà cung cấp được hiển thị ở đó" — đây là một điều kiện, không phải quy tắc chung, và "Mô hình mà opencode không thể định tuyến sẽ bị loại khỏi danh sách opencode, nhưng vẫn có thể hoạt động trong Quick Chat." Nếu bạn chạy backend Claude hoặc Codex, cách điều khiển nằm ở môi trường riêng của CLI đó: xem /docs/integrations/claude-code.

Bật CORS là một sự đánh đổi, không phải tùy chọn nên bật sẵn. Tài liệu viết: "Nếu Test thành công nhưng Quick Chat không thể gửi tin nhắn, hãy chỉnh sửa nhà cung cấp và bật Enable CORS. Khi đó, phản hồi sẽ xuất hiện sau khi hoàn tất thay vì truyền từng token." Tài liệu cũng lưu ý tùy chọn này không thay đổi định tuyến opencode, vì vậy bật nó để sửa Quick Chat sẽ khiến bạn mất đầu ra từng token ở đó, và không ảnh hưởng nơi nào khác.

Copilot 4.x không yêu cầu nhà cung cấp embedding: tính năng tìm kiếm ngữ nghĩa đã chuyển sang Miyo, một dịch vụ riêng, và hộp thoại BYOK không có trường tương ứng — điều này cũng hợp lý, vì Kunavo không cung cấp mô hình embedding và trang này sẽ không ngụ ý rằng có.

Kunavo chưa kiểm thử plugin này trong môi trường chạy thực tế. Tất cả các trường và trích dẫn ở trên đều được lấy từ tài liệu riêng của Copilot vào ngày bên dưới; trang hướng dẫn cấu hình đã xuất bản không phải là một lần chạy thử. Hãy gửi một tác vụ thực qua Quick Chat trước khi chuyển quy trình làm việc sang đây.

Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Copilot cho Obsidian.

Từng bước

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.
Trong Obsidian, mở Settings → Copilot → BYOK rồi nhấp Add a provider.
Chọn Add a custom provider thay vì nhà cung cấp có tên cụ thể hoặc mẫu Self Host.
Điền Display name, API key và Base URL như trên. Tạm thời để Enable CORS tắt.
Thêm ít nhất một mô hình — nhập một id trong Model ID → Add hoặc chọn từ Search available models, danh sách này được lấy từ GET /v1/models. Nhấp Test, rồi Save; không thể lưu cho đến khi có cả một mô hình và một endpoint có thể định tuyến.
Chọn lọc nơi các mô hình này xuất hiện tại Basic → Agents → Quick Chat và Basic → Agents → opencode, mỗi mục có Default model riêng. Theo mặc định, mô hình trò chuyện mới được bật cho cả hai.

Đã kiểm tra đối chiếu với Trang Nguồn mô hình và BYOK của Copilot 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.

Đây là phiên bản ngắn. Hướng dẫn đầy đủ — lựa chọn mô hình, chi phí của một phiên thực tế và các trường hợp lỗi — nằm trong backend Copilot nào thực sự thanh toán cho token.

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 Copilot cho Obsidian.

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

ID mô hình	Kunavo vào / ra	Phù hợp ở đâu trong Copilot cho Obsidian
`claude-haiku-4-5`	$0.70 / $3.50	Quick Chat, nơi các câu hỏi ngắn về ghi chú được gửi suốt ngày
`claude-sonnet-5`	$1.40 / $7.00	backend opencode trong Agent Chat — mô hình làm việc mặc định
`claude-opus-5`	$3.50 / $17.50	tổng hợp dài qua nhiều ghi chú, nơi đọc sai sẽ phải trả giá đắt
`gpt-5-6-sol`	$2.00 / $12.00	ý kiến thứ hai từ một họ mô hình khác, cùng khóa và cùng dòng nhà cung cấp

Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

Câu hỏi thường gặp

Tôi nhập khóa API ở đâu trong Obsidian Copilot?

Settings → Copilot → BYOK → Add a provider, sau đó chọn "Add a custom provider" cho endpoint không có trong danh sách tích hợp sẵn. Hộp thoại nhận Display name, API key, Base URL, công tắc Enable CORS tùy chọn và ít nhất một mô hình được thêm bằng id hoặc chọn từ danh sách được khám phá, sau đó nhấn Save. Tài liệu Copilot cho biết khóa nhà cung cấp được lưu trong Obsidian Keychain trên thiết bị đó thay vì trong data.json của vault, vì vậy đồng bộ vault sẽ không chuyển thông tin xác thực sang máy tính khác.

URL cơ sở của Obsidian Copilot có cần kết thúc bằng /v1 không?

Dùng dạng /v1 — https://api.kunavo.com/v1 cho Kunavo. Tài liệu không nêu quy tắc này trong một câu; tài liệu cho biết nhà cung cấp tùy chỉnh tương thích OpenAI phải có Base URL, việc khám phá mô hình dùng phản hồi /v1/models của endpoint, và hai mẫu tương thích OpenAI được cung cấp mặc định dùng http://localhost:11434/v1 và http://localhost:1234/v1. Cả hai URL mặc định đều có hậu tố này, đây là căn cứ mạnh nhất mà tài liệu đưa ra. URL cơ sở sai thường dẫn đến danh sách mô hình trống hoặc Test thất bại, chứ không phải lỗi xác thực.

Obsidian Copilot có thể dùng gateway như OpenRouter hoặc Kunavo thay cho khóa của nhà cung cấp không?

Có với Quick Chat, và có điều kiện với Agent Chat. Tài liệu riêng của Copilot mô tả BYOK là kết nối "trực tiếp với nhà cung cấp AI, gateway tương thích hoặc máy chủ mô hình trên máy tính của bạn", còn "Add a custom provider" nhận mọi URL cơ sở tương thích OpenAI cùng một model id. Sau đó, bảng nguồn mô hình chỉ định rõ mô hình BYOK cho Quick Chat và cho Agent Chat khi dùng backend opencode, nhưng chỉ "khi nhà cung cấp được hiển thị ở đó". Backend Claude và Codex hoàn toàn không nhận khóa BYOK — tài liệu nói rằng thêm khóa không làm thay đổi các mô hình mà chúng cung cấp.

Tôi có cần mô hình embedding để tìm kiếm trong vault của Obsidian Copilot không?

Không cần từ nhà cung cấp trò chuyện của bạn. Copilot 4.x không còn chạy chỉ mục riêng bên trong plugin: tài liệu cho biết tính năng tìm kiếm ngữ nghĩa và Relevant Notes do Miyo cung cấp, đây là dịch vụ riêng có thể chạy cục bộ hoặc từ xa, và hộp thoại BYOK không có trường cho loại mô hình đó. Kunavo cũng không cung cấp mô hình embedding, vì vậy không nên hiểu nội dung ở đây là có cung cấp mô hình đó — dòng nhà cung cấp trò chuyện trong Copilot chỉ thanh toán cho trò chuyện, không làm gì khác.

Khóa Kunavo có thay thế giấy phép Copilot Lite hoặc Plus không?

Không, và hai khoản này được tách riêng có chủ đích. Tài liệu Copilot xem giấy phép và BYOK là hai nguồn mô hình khác nhau: giấy phép cung cấp các mô hình do Copilot lưu trữ, được Brevilabs tính phí theo gói của bạn, còn BYOK gửi yêu cầu đến endpoint của bạn và chi phí vẫn do nhà cung cấp đó tính. Khóa tại đây không bổ sung hạn mức giấy phép, không mở khóa các dòng Copilot-hosted đang bị khóa và không thay đổi các dịch vụ phụ thuộc giấy phép; ngược lại, bạn có thể dùng BYOK ở gói miễn phí mà không cần giấy phép.