Dokumentasi

Dokumentasi

Msty Studio

Dokumentasi Msty Studio menyatakan bahwa endpoint yang kompatibel dengan OpenAI dapat ditambahkan sebagai penyedia, lalu berhenti di situ. Aplikasinya sendiri lebih spesifik — aplikasi menyebutkan jenis penyedia, kedua kolom, dan aturan /v1. Berikut formulir tersebut, dengan isian untuk Kunavo.

Model Hub > Model Providers > Add Provider > Open AI Compatible: API Key dan Inference Endpoint https://api.kunavo.com/v1 — catatan aplikasi sendiri menyebutkan bahwa sebagian besar endpoint yang kompatibel dengan OpenAI memerlukan /v1.

Msty Studio 2.9.11 — Tambahkan Penyedia
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
Tetap sertakan /v1 — Msty sendiri menyatakannya. Di bawah kolom Endpoint Inferensi, aplikasi yang dirilis menampilkan: “Sebagian besar endpoint penyedia yang kompatibel dengan OpenAI memerlukan jalur /v1, misalnya https://example.com/v1.” Msty Studio hanya menambahkan /models dan /chat/completions ke nilai yang Anda masukkan. Tanpa /v1, Ambil Model meminta https://api.kunavo.com/models dan permintaan obrolan dikirim ke https://api.kunavo.com/chat/completions; sejak 1 Oktober 2026, keduanya mengembalikan JSON 404 dengan pesan yang meminta penambahan /v1 (sebelumnya, pengambilan model membaca halaman web).
Asal label-label ini. Dokumentasi daring Msty tidak menyebutkan nama kolom. Label di atas adalah string yang disertakan dalam build desktop Msty Studio 2.9.11 (diunduh dari server Msty sendiri pada 1 Oktober 2026 dan dibaca tanpa menjalankannya), sehingga sesuai dengan tampilan aplikasi dalam bahasa Inggris. Rilis berikutnya mungkin mengubah redaksinya; aplikasi di layar Anda adalah acuan yang berwenang.
Belum dijalankan dari awal hingga akhir. Belum ada seorang pun di sini yang mengirim pesan dari Msty Studio ke Kunavo. Formulir penyedia, catatan /v1, dan jalur permintaan dibaca dari build yang dirilis, dan sisi Kunavo diperiksa dengan permintaan HTTP biasa. Streaming, panggilan alat, masukan gambar, dan kontrol penalaran melalui jenis penyedia ini belum diuji — obrolan pertama Anda adalah pemeriksaan sebenarnya.
Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Msty Studio.

Langkah demi langkah

  1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
  2. Di Msty Studio, buka Hub Model > Penyedia Model dan pilih Tambahkan Penyedia. Dalam daftar penyedia, di bawah judul Kompatibel dengan OpenAI, pilih Kompatibel dengan Open AI — bukan OpenAI, yang merupakan penyedia OpenAI tetap.
  3. Beri nama, tempelkan kunci ke Kunci API, lalu masukkan https://api.kunavo.com/v1 sebagai Endpoint Inferensi. Aplikasi mengharuskan nilainya dimulai dengan https://.
  4. Klik Ambil Model dan centang model yang Anda inginkan. Kunavo merespons GET /v1/models dengan katalog lengkap, jadi pilih beberapa model saja, bukan semuanya. Jika Anda mau, buka Tambahkan Model Kustom dan ketik ID Model persis seperti yang tertulis dalam katalog, misalnya claude-sonnet-5.
  5. Simpan Penyedia, lalu buka percakapan dan pilih salah satu modelnya — dokumentasi Msty sendiri menyebutkan langkah tersebut sebagai pengujian. Jika balasan diterima, endpoint, kunci, dan ID model semuanya sudah benar.

Diperiksa terhadap Halaman Penyedia Daring Msty Studio pada 1 Oktober 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di Harga Msty Studio dan biaya API.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di 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-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID modelKunavo masuk / keluarKegunaannya di Msty Studio
claude-sonnet-5$1.40 / $7.00Dokumen panjang dan obrolan Knowledge Stack, model yang seharusnya menjadi default untuk sebagian besar percakapan
gpt-5-6-terra$0.70 / $4.20Keluarga model kedua dalam panel perbandingan obrolan terbagi
claude-haiku-4-5$0.70 / $3.50Pertanyaan singkat, judul, dan apa pun yang Anda jalankan berkali-kali
Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Msty yang dibahas di sini

  • Msty Studio — ruang kerja desktop dan web yang dibahas halaman ini, dengan penyedia di Hub Model > Penyedia Model.
  • Msty Go — aplikasi agen terpisah dengan layar penyedia sendiri di Pengaturan; penyiapannya dijelaskan di halamannya sendiri.
  • Msty 1.x — aplikasi yang sudah dihentikan, dengan dokumentasi yang tidak lagi diperbarui di docs.msty.app tetapi masih muncul dalam peringkat pencarian. Layar-layarnya berbeda dari Studio.

Pesan yang ditampilkan aplikasi saat terjadi kegagalan

Berikut pesan yang disertakan dalam 2.9.11 dan arti masing-masing untuk endpoint ini:

  • “Endpoint penyedia tidak ditemukan. Periksa URL endpoint dan pastikan URL tersebut menyertakan jalur API yang benar, seperti /v1.” — Endpoint Inferensi belum menyertakan /v1.
  • “Tidak dapat terhubung ke endpoint penyedia…” — ada salah ketik pada host, atau http:// digunakan padahal seharusnya https://.
  • Ambil Model gagal tetapi URL sudah benar — periksa kunci. Daftar model Kunavo memerlukan kunci yang valid dan mengembalikan 401 jika tidak ada kunci yang valid.
  • Model tercantum tetapi obrolan menghasilkan kesalahan — formulir Msty sendiri memperingatkan bahwa “Tidak semua model telah diuji dengan Msty”. Daftar Kunavo mencakup model gambar, video, dan audio yang tidak dapat digunakan oleh jendela obrolan; pilih model obrolan.

Apa yang keluar dari mesin Anda

Msty menjelaskan penyedia daring sebagai cara untuk “menggunakan model yang dihosting dengan kunci API Anda, tanpa menjalankan inferensi model di perangkat Anda”. Jadi, percakapan pada model Kunavo mengirim prompt percakapan tersebut beserta konteks yang dilampirkan ke Kunavo, yang meneruskannya ke vendor model; percakapan pada model lokal tidak melakukan hal tersebut. Simpan materi sensitif pada model lokal jika batas ini penting bagi Anda.

Tingkat upaya penalaran pada jenis penyedia ini

Dokumentasi Msty mencantumkan dukungan tingkat upaya penalaran untuk “Model yang Kompatibel dengan OpenAI” hanya sebagai Tidak Ada dan Default, sementara penyedia Anthropic bawaan mendapatkan Berpikir Ringan, Sedang, dan Mendalam. Melalui jenis Kompatibel dengan Open AI, model Claude diperkirakan berjalan dengan penalaran default-nya, bukan dengan tingkat bertahap tersebut.

Pertanyaan umum

Bagaimana cara menambahkan penyedia kustom yang kompatibel dengan OpenAI di Msty Studio?

Buka Hub Model > Penyedia Model dan pilih Tambahkan Penyedia. Di bawah judul Kompatibel dengan OpenAI, pilih Kompatibel dengan Open AI, beri nama, tempelkan kunci Anda ke Kunci API, dan masukkan endpoint ke Endpoint Inferensi beserta jalur versinya — untuk Kunavo, https://api.kunavo.com/v1. Klik Ambil Model untuk memuat daftar, atau gunakan Tambahkan Model Kustom untuk mengetik ID Model, lalu Simpan Penyedia. Label tersebut adalah string dalam build Msty Studio 2.9.11; dokumentasi daring Msty menjelaskan alur yang sama tanpa menyebutkan nama kolom.

Apakah Msty Studio memerlukan /v1 dalam endpoint?

Untuk sebagian besar penyedia yang kompatibel dengan OpenAI, ya, dan aplikasi sendiri menyatakannya: di bawah kolom Endpoint Inferensi, aplikasi menampilkan "Sebagian besar endpoint penyedia yang kompatibel dengan OpenAI memerlukan jalur /v1, misalnya https://example.com/v1. Jika Anda mengalami masalah, coba tambahkan /v1 di akhir endpoint." Msty Studio hanya menambahkan /models dan /chat/completions, sehingga endpoint Kunavo adalah https://api.kunavo.com/v1. Tanpa /v1, pengambilan model dan obrolan sama-sama menerima 404 dengan pesan yang meminta penambahan /v1.

Apakah penyedia khusus Msty Studio sama dengan penyedia Msty Go?

Tidak. Keduanya adalah aplikasi terpisah dengan layar penyedia yang berbeda. Di Msty Studio, penyedia ditambahkan melalui Model Hub > Model Providers dengan jenis Open AI Compatible yang dijelaskan di sini. Msty Go, aplikasi agen yang sebelumnya bernama Msty Claw, mengonfigurasi penyedia melalui Settings > Model Providers dengan kumpulan kolomnya sendiri. Petunjuk penyiapan untuk salah satunya tidak berlaku untuk yang lain, dan keduanya tidak sama dengan aplikasi Msty 1.x yang sudah dihentikan, yang dokumentasi lamanya masih muncul di hasil pencarian.

Siapa yang menagih saya saat Msty Studio menggunakan penyedia khusus?

Ada dua pihak yang menagih secara terpisah. Msty menagih biaya paket aplikasi yang Anda gunakan, jika ada. Panggilan model ditagihkan oleh pihak yang menerbitkan kunci di kolom API Key milik penyedia — jika menggunakan kunci Kunavo, biayanya dihitung per token dari saldo prabayar Kunavo. Model lokal yang Anda jalankan di dalam Msty tidak dikenai biaya per permintaan. Paket dan perkiraan biaya percakapan dengan dokumen panjang pada tarif katalog dibahas di halaman harga Msty Studio yang ditautkan di atas.

Apakah Kunavo telah menguji Msty Studio?

Belum secara menyeluruh. Pada 1 Oktober 2026, aplikasi desktop resmi Msty Studio 2.9.11 diunduh dari server Msty dan diperiksa tanpa dijalankan: jenis penyedia, label kolom, catatan /v1, pesan kesalahan, dan jalur permintaan di halaman ini bersumber darinya. Sisi Kunavo diperiksa melalui permintaan HTTP langsung. Belum ada percakapan dari Msty Studio ke Kunavo yang dijalankan, sehingga streaming, penggunaan alat, dan masukan gambar melalui penyedia ini belum diverifikasi.