ドキュメント

ドキュメント

Msty Studio

Msty Studioのドキュメントには、OpenAI互換エンドポイントをプロバイダーとして追加できるとだけ記載されています。一方、アプリ本体には、プロバイダーの種類、2つのフィールド、/v1のルールがより具体的に示されています。ここでは、Kunavo向けにそのフォームを入力した例を紹介します。

Model Hub > Model Providers > Add Provider > Open AI Compatible:API KeyにAPIキーを、Inference Endpointにhttps://api.kunavo.com/v1を指定 — アプリの注記では、ほとんどのOpenAI互換エンドポイントで/v1が必要とされています。

Msty Studio 2.9.11 — Add Provider
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は残してください。Msty自身がそう明記しています。 付属アプリのInference Endpoint欄の下には、「ほとんどのOpenAI互換プロバイダーのエンドポイントには/v1パスが必要です。例:https://example.com/v1」と表示されます。Msty Studioが入力値に追加するのは/modelsと/chat/completionsだけです。/v1がないと、Fetch Modelsはhttps://api.kunavo.com/modelsを要求し、チャットリクエストはhttps://api.kunavo.com/chat/completionsに送られます。2026年10月1日以降は、どちらも/v1を追加するよう促すメッセージを含むJSONの404を返します。それ以前は、モデル取得時にウェブページを読み取っていました。
これらの表示名の出所。Mstyのオンラインドキュメントにはフィールド名が記載されていません。上記の表示名は、Msty Studio 2.9.11のデスクトップビルド(2026年10月1日にMstyの公式サーバーからダウンロードし、起動せずに確認)に含まれている文字列で、アプリの英語表示と一致します。今後のリリースで表現が変わる場合があるため、画面に表示される内容を基準にしてください。
一連の動作は未検証です。ここでは誰もMsty StudioからKunavoにメッセージを送っていません。プロバイダーフォーム、/v1の注記、リクエストパスはリリース済みビルドで確認し、Kunavo側は通常のHTTPリクエストで確認しました。このプロバイダーの種類を介したストリーミング、ツール呼び出し、画像入力、思考制御はテストしていません。実際の確認は、最初のチャットで行ってください。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Msty Studio設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. Msty StudioでModel Hub > Model Providersを開き、Add Providerを選択します。プロバイダー一覧のOpenAI Compatible見出しの下にあるOpen AI Compatibleを選びます。固定のOpenAIプロバイダーであるOpenAIは選ばないでください。
  3. プロバイダー名を入力し、キーをAPI Keyに貼り付け、Inference Endpointにhttps://api.kunavo.com/v1を入力します。アプリは、値がhttps://で始まることを求めます。
  4. Fetch Modelsをクリックし、使いたいモデルにチェックを入れます。KunavoはGET /v1/modelsに全カタログを返すため、すべてではなく、必要なものをいくつか選択してください。必要に応じてAdd Custom Modelを開き、カタログの表記どおりにModel IDを入力します。たとえばclaude-sonnet-5です。
  5. Save Providerをクリックし、会話を開いて、追加したモデルのいずれかを選びます。Msty自身のドキュメントでは、これをテスト手順として案内しています。応答が返れば、エンドポイント、キー、モデルIDはすべて正しく設定されています。

Msty StudioのOnline Providersページで2026年10月1日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — はMsty Studioの料金とAPI利用料にあります。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーが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

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

モデル IDKunavo 入力 / 出力Msty Studioでの位置付け
claude-sonnet-5$1.40 / $7.00長文書やKnowledge Stackのチャットなど、ほとんどの会話で既定モデルとして使うモデル
gpt-5-6-terra$0.70 / $4.20分割チャットの比較ペインで使う、2つ目のモデル群
claude-haiku-4-5$0.70 / $3.50簡単な質問、タイトル、何度も実行する処理
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト(エディターやチャットクライアントが送る内容の大半)では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

対象となるMsty

  • Msty Studio — このページで扱うデスクトップおよびウェブのワークスペースです。プロバイダーはModel Hub > Model Providersから設定します。
  • Msty Go — Settingsに独自のプロバイダー画面がある別のエージェントアプリです。セットアップ方法は専用ページを参照してください。
  • Msty 1.x — 現役を退いたアプリです。docs.msty.appにある更新停止済みのドキュメントは、今も検索結果に表示されます。その画面はStudioのものとは異なります。

アプリに表示されるエラーとその意味

以下は2.9.11に含まれているメッセージと、このエンドポイントでの意味です。

  • 「プロバイダーのエンドポイントが見つかりませんでした。エンドポイントURLを確認し、/v1などの正しいAPIパスが含まれていることを確認してください。」 — Inference Endpointに/v1がありません。
  • 「プロバイダーのエンドポイントに接続できません…」 — ホスト名の誤入力、またはhttps://であるべき箇所がhttp://になっています。
  • Fetch Modelsが失敗するが、URLは正しい — キーを確認してください。Kunavoのモデル一覧には有効なキーが必要で、キーがないと401を返します。
  • モデルは一覧に表示されるが、チャットでエラーになる — Msty自身のフォームには「すべてのモデルがMstyでテストされているわけではありません」との警告があります。Kunavoの一覧には、チャットウィンドウでは使用できない画像、動画、音声モデルも含まれています。チャットモデルを選んでください。

端末から送信されるデータ

Mstyはオンラインプロバイダーを、「デバイス上でモデル推論を実行せずに、APIキーを使ってホストされたモデルを利用する」方法と説明しています。したがって、Kunavoのモデルで会話すると、その会話のプロンプトと添付されたコンテキストがKunavoに送られ、Kunavoがモデルベンダーに転送します。ローカルモデルでの会話では送られません。この境界が重要であれば、機密情報はローカルモデルで扱ってください。

このプロバイダーの種類での思考レベル

Mstyのドキュメントでは、「OpenAI互換モデル」の思考努力レベルへの対応は「なし」と「デフォルト」のみとされています。一方、ネイティブのAnthropicプロバイダーには「軽く考える」「適度に考える」「深く考える」があります。Open AI Compatibleタイプ経由では、Claudeモデルは段階別のレベルではなく、デフォルトの推論で動作すると考えてください。

よくある質問

Msty StudioにOpenAI互換のカスタムプロバイダーを追加するにはどうすればよいですか?

Model Hub > Model Providersを開き、Add Providerを選択します。OpenAI Compatible見出しの下にあるOpen AI Compatibleを選び、名前を付けて、API Keyにキーを貼り付けます。Inference Endpointには、バージョンパスを含むエンドポイントを入力します。Kunavoの場合はhttps://api.kunavo.com/v1です。Fetch Modelsをクリックして一覧を読み込むか、Add Custom ModelからModel IDを入力し、Save Providerをクリックします。これらの表示名はMsty Studio 2.9.11ビルドに含まれる文字列です。Mstyのオンラインドキュメントは同じ手順を説明していますが、フィールド名は記載していません。

Msty Studioのエンドポイントには/v1が必要ですか?

ほとんどのOpenAI互換プロバイダーでは必要です。アプリ自身もそう案内しています。Inference Endpoint欄には、「OpenAI互換プロバイダーのエンドポイントのほとんどは、/v1パスを必要とします。例:https://example.com/v1。問題が発生する場合は、エンドポイントに/v1を追加してみてください」と表示されます。Msty Studioが追加するのは/modelsと/chat/completionsのみなので、Kunavoのエンドポイントはhttps://api.kunavo.com/v1です。/v1を付けない場合、モデル取得とチャットの両方で、/v1を追加するよう案内するメッセージを含む404が返ります。

Msty StudioのカスタムプロバイダーはMsty Goのものと同じですか?

いいえ。別々のプロバイダー画面を持つ別々のアプリです。Msty Studioでは、Model Hub > Model Providersから、このページで説明するOpen AI Compatibleの種類を使ってプロバイダーを追加します。以前Msty Clawと呼ばれていたエージェントアプリのMsty Goでは、Settings > Model Providersから独自のフィールドを使って設定します。一方のセットアップ手順をもう一方に適用することはできません。また、検索結果に古いドキュメントが表示されるサポート終了済みのMsty 1.xとも異なります。

Msty Studioでカスタムプロバイダーを使うと、誰から請求されますか?

請求元は2者で、それぞれ別です。Mstyは、該当する場合、利用しているアプリのプラン料金を請求します。モデル呼び出しの料金は、プロバイダーのAPI Key欄に入力したキーの発行元が請求します。Kunavoのキーを使う場合、プリペイド残高からトークン単位で差し引かれます。Msty内で実行するローカルモデルは、リクエストごとの料金はかかりません。プランと、カタログ料金に基づく長文書の会話にかかる一般的な費用については、上記リンク先のMsty Studioの料金ページで説明しています。

KunavoはMsty Studioをテストしましたか?

一連の動作は未検証です。2026年10月1日、Msty Studio 2.9.11の公式デスクトップビルドをMstyのサーバーからダウンロードし、起動せずに確認しました。このページにあるプロバイダーの種類、フィールド名、/v1の注記、エラーメッセージ、リクエストパスはそのビルドに基づいています。Kunavo側は直接HTTPリクエストで確認しました。Msty StudioからKunavoへのチャットは実行していないため、このプロバイダー経由のストリーミング、ツールの使用、画像入力は未検証です。