Dokümantasyon

Dokümantasyon

Msty Studio

Msty Studio belgelerinde OpenAI uyumlu bir uç noktanın sağlayıcı olarak eklenebileceği söyleniyor, ardından başka ayrıntı verilmiyor. Uygulamanın kendisi daha fazla bilgi veriyor — sağlayıcı türünü, iki alanı ve /v1 kuralını adlandırıyor. İşte Kunavo için doldurulmuş form.

Model Hub > Model Providers > Add Provider > Open AI Compatible: https://api.kunavo.com/v1 değerinde bir API Key ve Inference Endpoint — uygulamanın kendi notu, OpenAI uyumlu uç noktaların çoğunda /v1 gerektiğini söylüyor.

Msty Studio 2.9.11 — Sağlayıcı Ekle
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
/v1 değerini koruyun — Msty'nin kendi ifadesi. Uygulamanın dağıtılan sürümünde Inference Endpoint alanının altında şu ifade yer alıyor: “OpenAI uyumlu sağlayıcı uç noktalarının çoğu /v1 yolunu gerektirir; örneğin https://example.com/v1.” Msty Studio, yazdığınız değere yalnızca /models ve /chat/completions ekler. /v1 olmadan Fetch Models isteği https://api.kunavo.com/models adresine, sohbet istekleri ise https://api.kunavo.com/chat/completions adresine gider. 1 Ekim 2026'dan beri ikisi de /v1 eklenmesini söyleyen bir JSON 404 yanıtı veriyor (öncesinde model getirme isteği bir web sayfası okuyordu).
Bu etiketlerin kaynağı. Msty'nin çevrimiçi belgelerinde alan adları belirtilmiyor. Yukarıdaki etiketler, Msty Studio 2.9.11 masaüstü derlemesindeki dizelerdir (1 Ekim 2026'da Msty'nin kendi sunucularından indirildi ve uygulama başlatılmadan incelendi); dolayısıyla uygulamanın İngilizce arayüzündeki ifadelerle eşleşir. Daha sonraki bir sürümde bu ifadeler değişebilir; ekranda gördüğünüz uygulama belirleyicidir.
Uçtan uca çalıştırılmadı. Burada kimse Msty Studio'dan Kunavo'ya mesaj göndermedi. Sağlayıcı formu, /v1 notu ve istek yolları yayımlanan derlemeden okundu; Kunavo tarafı ise düz HTTP istekleriyle kontrol edildi. Bu sağlayıcı türü üzerinden akış, araç çağrıları, görüntü girdisi ve düşünme denetimleri test edilmedi — ilk sohbetiniz gerçek kontroldür.
Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Msty Studio kurulumunda açılır.

Adım adım

  1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
  2. Msty Studio'da Model Hub > Model Providers bölümünü açın ve Add Provider seçeneğini belirleyin. Sağlayıcı listesinde OpenAI Compatible başlığı altından Open AI Compatible seçeneğini seçin — sabit OpenAI sağlayıcısı olan OpenAI'ı değil.
  3. Sağlayıcıya bir ad verin, anahtarı API Key alanına yapıştırın ve https://api.kunavo.com/v1 değerini Inference Endpoint olarak girin. Uygulama, bu değerin https:// ile başlamasını gerektirir.
  4. Fetch Models'a tıklayın ve istediğiniz modelleri işaretleyin. Kunavo GET /v1/models adresinde tüm kataloğu döndürür; bu nedenle tümünü değil, birkaç modeli seçin. İsterseniz Add Custom Model bölümünü açıp katalogdaki biçimiyle tam olarak eşleşen bir Model ID yazın; örneğin claude-sonnet-5.
  5. Save Provider'a tıklayın, ardından bir konuşma açıp modellerinden birini seçin — Msty'nin kendi belgelerinde test adımı olarak bu belirtiliyor. Yanıt gelirse uç nokta, anahtar ve model kimliği doğrudur.

Msty Studio'nun Online Providers sayfası ile 1 Ekim 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Msty Studio fiyatlandırması ve API maliyeti içindedir.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Msty Studio içinde çalışır.

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

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliğiKunavo giriş / çıkışMsty Studio içinde kullanım alanı
claude-sonnet-5$1.40 / $7.00Uzun belgeler ve Knowledge Stack sohbetleri; konuşmaların çoğunda varsayılan olması gereken model
gpt-5-6-terra$0.70 / $4.20Bölünmüş sohbet karşılaştırma bölmesinde ikinci bir model ailesi
claude-haiku-4-5$0.70 / $3.50Kısa sorular, başlıklar ve sık çalıştırdığınız her şey
Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Hangi Msty ürününden söz edildiği

  • Msty Studio — bu sayfanın konusu olan, sağlayıcıları Model Hub > Model Providers altında bulunan masaüstü ve web çalışma alanı.
  • Msty Go — Settings altında ayrı sağlayıcı ekranı bulunan farklı bir ajan uygulaması; kurulumu kendine ait sayfada açıklanıyor.
  • Msty 1.x — belgeleri docs.msty.app adresinde hâlâ arama sonuçlarında üst sıralarda yer alan emekliye ayrılmış uygulama. Ekranları Studio'nunkilerle aynı değildir.

Uygulamanın hata durumunda gösterdikleri

Bunlar 2.9.11 sürümünde yer alan mesajlar ve her birinin bu uç nokta için anlamı:

  • “Sağlayıcı uç noktası bulunamadı. Uç nokta URL'sini doğrulayın ve /v1 gibi doğru API yolunu içerdiğinden emin olun.” — Inference Endpoint değerinde /v1 eksik.
  • “Sağlayıcı uç noktasına bağlanılamıyor…” — ana makine adresinde yazım hatası var veya http:// yerine https:// kullanılmış.
  • Fetch Models başarısız oluyor, ancak URL doğru — anahtarı kontrol edin. Kunavo'nun model listesi geçerli bir anahtar gerektirir ve anahtar olmadan 401 yanıtı verir.
  • Model listeleniyor, ancak sohbet hata veriyor — Msty'nin kendi formunda “Tüm modeller Msty ile test edilmemiştir” uyarısı yer alıyor. Kunavo'nun listesinde sohbet penceresinin kullanamayacağı görüntü, video ve ses modelleri bulunur; bir sohbet modeli seçin.

Makinenizden gönderilenler

Msty, çevrimiçi sağlayıcıları “model çıkarımını cihazınızda çalıştırmadan, API anahtarlarınızla barındırılan modelleri kullanmanın” bir yolu olarak tanımlıyor. Dolayısıyla Kunavo modelindeki bir konuşmanın istemi ve ekli bağlamı Kunavo'ya gönderilir; Kunavo da bunları model satıcısına iletir. Yerel bir modeldeki konuşma ise gönderilmez. Bu sınır sizin için önemliyse hassas materyalleri yerel modellerde tutun.

Bu sağlayıcı türünde düşünme düzeyi

Msty belgelerinde “OpenAI Compatible Models” için düşünme düzeyi desteği Yalnızca None ve Default olarak listelenirken, yerleşik Anthropic sağlayıcısında Think Lightly, Moderately ve Deeply seçenekleri bulunuyor. Open AI Compatible türü üzerinden Claude modelinin kademeli düzeylerde değil, varsayılan akıl yürütme ayarında çalışmasını bekleyin.

Sık sorulan sorular

Msty Studio'da özel bir OpenAI uyumlu sağlayıcıyı nasıl eklerim?

Model Hub > Model Providers bölümünü açıp Add Provider'ı seçin. OpenAI Compatible başlığı altından Open AI Compatible'ı seçin, bir ad verin, anahtarı API Key alanına yapıştırın ve uç noktayı sürüm yolu dahil olmak üzere Inference Endpoint alanına girin — Kunavo için https://api.kunavo.com/v1. Listeyi yüklemek için Fetch Models'a tıklayın veya Model ID yazmak için Add Custom Model'ı kullanın; ardından Save Provider'ı seçin. Bu etiketler Msty Studio 2.9.11 derlemesindeki ifadelerdir; Msty'nin çevrimiçi belgelerinde aynı akış anlatılıyor, ancak alanların adları belirtilmiyor.

Msty Studio uç noktasında /v1 bulunmalı mı?

OpenAI uyumlu sağlayıcıların çoğunda evet; uygulama bunu kendisi de belirtiyor: Inference Endpoint alanının altında “OpenAI uyumlu sağlayıcı uç noktalarının çoğu /v1 yolunu gerektirir; örneğin https://example.com/v1. Sorun yaşıyorsanız uç noktaya /v1 eklemeyi deneyin.” ifadesi gösteriliyor. Msty Studio yalnızca /models ve /chat/completions ekliyor; dolayısıyla Kunavo'nun uç noktası https://api.kunavo.com/v1 olmalı. /v1 olmadan hem model getirme hem sohbet istekleri, /v1 eklenmesini söyleyen bir 404 hatası verir.

Msty Studio’nun özel sağlayıcısı, Msty Go’nunkiyle aynı mı?

Hayır. Bunlar, sağlayıcı ekranları ayrı olan farklı uygulamalardır. Msty Studio’da sağlayıcılar, burada açıklanan Open AI Compatible türüyle Model Hub > Model Providers altından eklenir. Eskiden Msty Claw olarak adlandırılan ajan uygulaması Msty Go’da ise sağlayıcılar, kendine özgü alanlarıyla Settings > Model Providers altından yapılandırılır. Birine ait kurulum talimatları diğerinde geçerli değildir. Ayrıca ikisi de eski belgeleri arama sonuçlarında hâlâ görünen, kullanımdan kaldırılmış Msty 1.x uygulamasıyla aynı değildir.

Msty Studio özel bir sağlayıcı kullandığında ücreti kim alır?

Ücreti iki taraf ayrı ayrı alır. Varsa Msty, kullandığınız uygulama katmanı için ücret alır. Model çağrılarının ücretini, sağlayıcının API Key alanındaki anahtarı veren taraf alır; Kunavo anahtarıyla, ön ödemeli Kunavo bakiyesinden token başına ücretlendirilirsiniz. Msty içinde çalıştırdığınız yerel modellerin istek başına maliyeti yoktur. Katmanlar ve katalog fiyatları üzerinden tipik bir uzun belge sohbetinin maliyeti, yukarıda bağlantısı verilen Msty Studio fiyatlandırma sayfasında açıklanmıştır.

Kunavo, Msty Studio’yu test etti mi?

Uçtan uca test etmedi. 1 Ekim 2026’da resmi Msty Studio 2.9.11 masaüstü sürümü Msty sunucularından indirildi ve çalıştırılmadan incelendi: bu sayfadaki sağlayıcı türü, alan etiketleri, /v1 notu, hata mesajları ve istek yolları bu sürümden alınmıştır. Kunavo tarafı doğrudan HTTP istekleriyle kontrol edildi. Msty Studio’dan Kunavo’ya hiçbir sohbet gönderilmedi; bu nedenle bu sağlayıcı üzerinden akış, araç kullanımı ve görsel girişi doğrulanmamıştır.