Tài liệu
Msty Studio
Tài liệu của Msty Studio cho biết có thể thêm endpoint tương thích OpenAI làm nhà cung cấp rồi dừng ở đó. Bản thân ứng dụng cung cấp thông tin cụ thể hơn — nêu loại nhà cung cấp, hai trường và quy tắc /v1. Dưới đây là biểu mẫu đã điền cho Kunavo.
Model Hub > Model Providers > Add Provider > Open AI Compatible: API Key và Inference Endpoint là https://api.kunavo.com/v1 — ghi chú của ứng dụng cho biết hầu hết endpoint tương thích OpenAI cần /v1.
Model Hub > Model Providers > Add Provider
Provider Open AI Compatible (under "OpenAI Compatible")
Name Kunavo "Give it a name (optional)"
API Key sk-kn-...
Inference Endpoint https://api.kunavo.com/v1 <- keep the /v1
Models Fetch Models, then tick the ids you want
(or Add Custom Model: Model ID + Model Name)
→ Save Provider/models và /chat/completions vào giá trị bạn nhập. Nếu thiếu /v1, Fetch Models sẽ gửi yêu cầu đến https://api.kunavo.com/models và các yêu cầu trò chuyện sẽ gửi đến https://api.kunavo.com/chat/completions; kể từ ngày 1 tháng 10 năm 2026, cả hai đều trả về lỗi 404 dạng JSON với thông báo yêu cầu thêm /v1 (trước đó, thao tác tìm nạp mô hình trả về một trang web).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 Msty Studio.Từng bước
- Tạo khóa tại
/app/keysrồi sao chép khóa — khóa chỉ hiển thị một lần. - Trong Msty Studio, mở Model Hub > Model Providers rồi chọn Add Provider. Trong danh sách nhà cung cấp, dưới tiêu đề OpenAI Compatible, chọn Open AI Compatible — không chọn OpenAI, vốn là nhà cung cấp OpenAI cố định.
- Đặt tên cho nhà cung cấp, dán khóa vào API Key và nhập
https://api.kunavo.com/v1vào trường Inference Endpoint. Ứng dụng yêu cầu URL phải bắt đầu bằnghttps://. - Nhấn Fetch Models rồi đánh dấu các mô hình bạn muốn. Kunavo trả về
GET /v1/modelscùng toàn bộ danh mục, vì vậy hãy chọn một vài mô hình thay vì chọn tất cả. Nếu muốn, hãy mở Add Custom Model và nhập một Model ID đúng chính tả như trong danh mục, chẳng hạnclaude-sonnet-5. - Chọn Save Provider, sau đó mở cuộc trò chuyện và chọn một trong các mô hình của nhà cung cấp — tài liệu của chính Msty đưa ra bước này để kiểm tra. Nếu nhận được phản hồi, endpoint, khóa và model id đều chính xác.
Đã kiểm tra đối chiếu với Trang Nhà cung cấp trực tuyến của Msty Studio vào 1 tháng 10, 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 Msty Studio.
# 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 Msty Studio |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | Tài liệu dài và các cuộc trò chuyện Knowledge Stack, mô hình mà phần lớn cuộc trò chuyện nên dùng mặc định |
gpt-5-6-terra | $0.70 / $4.20 | Một họ mô hình thứ hai trong khung so sánh trò chuyện chia đôi |
claude-haiku-4-5 | $0.70 / $3.50 | Câu hỏi nhanh, tiêu đề và mọi việc bạn thực hiện nhiều lần |
Sản phẩm Msty nào đang được nói đến
- Msty Studio — không gian làm việc trên máy tính để bàn và web được đề cập trong trang này, có nhà cung cấp tại Model Hub > Model Providers.
- Msty Go — một ứng dụng tác tử riêng, có màn hình nhà cung cấp riêng trong Settings; hướng dẫn thiết lập nằm trên trang riêng.
- Msty 1.x — ứng dụng đã ngừng hoạt động, nhưng tài liệu cũ không còn được cập nhật tại docs.msty.app vẫn xuất hiện cao trên kết quả tìm kiếm. Giao diện của ứng dụng này không phải giao diện của Studio.
Thông báo của ứng dụng khi xảy ra lỗi
Đây là các thông báo có trong bản 2.9.11 và ý nghĩa của từng thông báo đối với endpoint này:
- “Không tìm thấy endpoint của nhà cung cấp. Hãy xác minh URL endpoint và đảm bảo URL có đường dẫn API chính xác, chẳng hạn /v1.” — Inference Endpoint thiếu
/v1. - “Không thể kết nối với endpoint của nhà cung cấp…” — tên máy chủ bị nhập sai hoặc dùng
http://ở vị trí cầnhttps://. - Fetch Models không thành công dù URL đúng — hãy kiểm tra khóa. Danh sách mô hình của Kunavo cần khóa hợp lệ và sẽ trả về 401 nếu không có khóa.
- Mô hình có trong danh sách nhưng trò chuyện báo lỗi — biểu mẫu của Msty cảnh báo: “Không phải tất cả mô hình đều đã được kiểm thử với Msty”. Danh sách của Kunavo có các mô hình hình ảnh, video và âm thanh mà cửa sổ trò chuyện không thể dùng; hãy chọn mô hình trò chuyện.
Dữ liệu rời khỏi máy của bạn
Msty mô tả các nhà cung cấp trực tuyến là cách để “sử dụng các mô hình được lưu trữ bằng khóa API của bạn mà không chạy suy luận mô hình trên thiết bị”. Vì vậy, khi trò chuyện bằng mô hình Kunavo, câu lệnh và ngữ cảnh đính kèm của cuộc trò chuyện sẽ được gửi đến Kunavo, rồi Kunavo chuyển tiếp đến nhà cung cấp mô hình; còn cuộc trò chuyện bằng mô hình cục bộ thì không. Nếu ranh giới này quan trọng với bạn, hãy giữ tài liệu nhạy cảm trên các mô hình cục bộ.
Mức độ suy nghĩ của kiểu nhà cung cấp này
Tài liệu của Msty liệt kê mức hỗ trợ mức độ suy nghĩ cho “OpenAI Compatible Models” là None và Default; trong khi đó, nhà cung cấp Anthropic gốc có các mức Think Lightly, Moderately và Deeply. Với kiểu Open AI Compatible, hãy dự kiến mô hình Claude chạy ở mức suy luận mặc định thay vì các mức phân loại.
Câu hỏi thường gặp
Làm thế nào để thêm nhà cung cấp tùy chỉnh tương thích OpenAI trong Msty Studio?
Mở Model Hub > Model Providers rồi chọn Add Provider. Trong mục OpenAI Compatible, chọn Open AI Compatible, đặt tên, dán khóa vào API Key và nhập endpoint vào Inference Endpoint, bao gồm cả đường dẫn phiên bản — với Kunavo là https://api.kunavo.com/v1. Nhấn Fetch Models để tải danh sách hoặc dùng Add Custom Model để nhập Model ID, sau đó chọn Save Provider. Các nhãn đó là chuỗi ký tự trong bản dựng Msty Studio 2.9.11; tài liệu trực tuyến của Msty mô tả cùng quy trình nhưng không nêu tên các trường.
Msty Studio có cần /v1 trong endpoint không?
Với hầu hết nhà cung cấp tương thích OpenAI thì có, và chính ứng dụng cũng nêu rõ: dưới trường Inference Endpoint, ứng dụng hiển thị “Hầu hết endpoint của nhà cung cấp tương thích OpenAI cần đường dẫn /v1, ví dụ https://example.com/v1. Nếu gặp sự cố, hãy thử nối thêm /v1 vào endpoint.” Msty Studio chỉ nối thêm /models và /chat/completions, vì vậy endpoint của Kunavo là https://api.kunavo.com/v1. Nếu thiếu /v1, cả thao tác tìm nạp mô hình lẫn trò chuyện đều trả về lỗi 404 với thông báo yêu cầu thêm /v1.
Nhà cung cấp tùy chỉnh của Msty Studio có giống Msty Go không?
Không. Đây là hai ứng dụng riêng biệt, với các màn hình nhà cung cấp riêng. Trong Msty Studio, thêm nhà cung cấp tại Model Hub > Model Providers bằng loại Open AI Compatible được mô tả ở đây. Msty Go, ứng dụng agent trước đây có tên Msty Claw, cấu hình nhà cung cấp tại Settings > Model Providers với bộ trường riêng. Hướng dẫn thiết lập cho ứng dụng này không áp dụng cho ứng dụng kia; cả hai cũng đều khác ứng dụng Msty 1.x đã ngừng hoạt động, tài liệu cũ của ứng dụng này vẫn xuất hiện trong kết quả tìm kiếm.
Khi Msty Studio dùng nhà cung cấp tùy chỉnh, bên nào tính phí cho tôi?
Hai bên tính phí riêng. Msty tính phí theo gói ứng dụng bạn dùng, nếu có. Bên phát hành khóa trong trường API Key của nhà cung cấp sẽ tính phí cho các lần gọi mô hình — nếu dùng khóa Kunavo, phí được tính theo token và trừ vào số dư Kunavo trả trước. Các mô hình cục bộ chạy bên trong Msty không mất phí cho mỗi yêu cầu. Các gói và chi phí của một cuộc trò chuyện thông thường với tài liệu dài, tính theo giá trong danh mục, được trình bày trên trang giá Msty Studio được liên kết ở trên.
Kunavo đã kiểm thử Msty Studio chưa?
Chưa kiểm thử từ đầu đến cuối. Ngày 1 tháng 10 năm 2026, bản desktop chính thức Msty Studio 2.9.11 đã được tải từ máy chủ của Msty và đọc mà không khởi chạy: loại nhà cung cấp, nhãn trường, ghi chú /v1, thông báo lỗi và các đường dẫn yêu cầu trên trang này đều lấy từ bản đó. Phía Kunavo được kiểm tra bằng các yêu cầu HTTP trực tiếp. Chưa có cuộc trò chuyện nào từ Msty Studio đến Kunavo được chạy, vì vậy tính năng truyền phát, sử dụng công cụ và đầu vào hình ảnh qua nhà cung cấp này chưa được xác minh.