Tài liệu

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.

Msty Studio 2.9.11 — Thêm nhà cung cấp
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
Hãy giữ /v1 — chính Msty đã nêu rõ. Dưới trường Inference Endpoint, ứng dụng được phát hành 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.” Msty Studio chỉ nối thêm /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).
Nguồn gốc của các nhãn này. Tài liệu trực tuyến của Msty không nêu tên các trường. Các nhãn phía trên là chuỗi ký tự có trong bản dựng ứng dụng máy tính để bàn Msty Studio 2.9.11 (tải từ máy chủ của chính Msty vào ngày 1 tháng 10 năm 2026 và đọc mà không khởi chạy ứng dụng), nên khớp với nội dung ứng dụng hiển thị bằng tiếng Anh. Bản phát hành sau có thể đổi cách diễn đạt; nội dung trong ứng dụng của bạn mới là căn cứ.
Chưa kiểm thử toàn trình. Chưa ai ở đây gửi tin nhắn từ Msty Studio đến Kunavo. Biểu mẫu nhà cung cấp, ghi chú về /v1 và đường dẫn yêu cầu được đọc từ bản phát hành; phía Kunavo được kiểm tra bằng các yêu cầu HTTP thông thường. Khả năng truyền phát, gọi công cụ, nhập hình ảnh và các tùy chọn suy nghĩ qua kiểu nhà cung cấp này chưa được kiểm thử — cuộc trò chuyện đầu tiên của bạn mới là lần kiểm tra thực tế.
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 Msty Studio.

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. 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.
  3. Đặt tên cho nhà cung cấp, dán khóa vào API Key và nhập https://api.kunavo.com/v1 vào trường Inference Endpoint. Ứng dụng yêu cầu URL phải bắt đầu bằng https://.
  4. Nhấn Fetch Models rồi đánh dấu các mô hình bạn muốn. Kunavo trả về GET /v1/models cù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ạn claude-sonnet-5.
  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.

Đâ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 Chi phí Msty Studio và chi phí API.

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ìnhKunavo vào / raPhù hợp ở đâu trong Msty Studio
claude-sonnet-5$1.40 / $7.00Tà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.20Một họ mô hình thứ hai trong khung so sánh trò chuyện chia đôi
claude-haiku-4-5$0.70 / $3.50Câu hỏi nhanh, tiêu đề và mọi việc bạn thực hiện nhiều lần
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.

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ần https://.
  • 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.