ドキュメント

ドキュメント

ChatWise

ChatWiseでは、すべてのプロバイダーが共通の3つの入力欄を使います。カスタムプロバイダーに名前、API Base URL、キーを設定してFetchを押すと、モデル選択欄にClaudeとGPTのIDが表示され、どちらも同じ残高から利用できます。

Settings → Providers → "+"で3つのフィールドからカスタムプロバイダーを作成 — Provider name、https://api.kunavo.com/v1に設定したAPI Base URL、API Key — その後Fetchでエンドポイントからモデル一覧を読み込みます。

Settings → Providers → "+" → カスタム設定
Provider name    Kunavo
API Base URL     https://api.kunavo.com/v1
                 field help: "Do NOT include /chat/completions in the URL"
API Key          sk-kn-...
Models           click Fetch to read the list from the endpoint,
                 or "+ New" and type an id by hand

"+ New" → Chat Models, the fields the docs name:
  Model ID       claude-sonnet-5
  Display Name   Claude Sonnet 5 (Kunavo)
  Capabilities   image input / reasoning flag — tick what the model does
  Context length as published on the models page
API Base URL には /v1 も含めます。 ChatWise はフィールドの下に「URL に /chat/completions を含めないでください」と明記しています。したがって、ここに入力するのはルートが続くベース URL であり、ルート自体ではありません。ドキュメントに記載された、入力欄を埋めたホステッドゲートウェイの例も同じ形式です: https://aihubmix.com/v1。ルートを含むベース URL を指定すると、認証エラーではなく 404 エラーになります。
以下は、下記の日付時点におけるChatWiseの公式ドキュメントに基づく設定方法です。KunavoではChatWiseを使ってエンドポイントを実行していません。セッション、ストリーミングによるターン、ツールの往復呼び出しのいずれも確認しておらず、このファミリーに属する他のすべてのクライアントについても同様です。設定手順を公開していることは、互換性をテストしたことを意味しません。この設定を試す間も、現在動作しているルートを使える状態にしておいてください。
Kunavoは埋め込み、テキスト読み上げ、音声テキスト化のモデルを提供していないため、このルートではチャットと画像生成のみを利用でき、それ以外には対応しません。ChatWiseの音声入力機能には影響しません。これは音声ファイルを受け付けるモデルへのメッセージに添付する機能であり、文字起こしサービスを呼び出す機能ではありません。
このフィールドに入力すると、ChatWise の拡張機能が1つ無効になります。オブザーバビリティのページには、「それぞれのプロバイダーの API Base URL が空であることを確認してください。そうでない場合、オブザーバビリティは有効になりません」とあります。Cloudflare AI Gateway ダッシュボードと、別のベース URL を設定する方法は、プロバイダーごとにどちらか一方しか使えません。そのため、組み込みプロバイダーを編集するのではなく、Kunavo を独自のプロバイダーとして追加するのが適切です。
ChatWiseという名称を使う、互いに無関係な製品がいくつかあります。このページで扱うのはchatwise.appのデスクトップクライアント(macOS、Windows、Linux対応)で、ドキュメントはdocs.chatwise.appにあります。公開GitHubリリースフィードは現行の出荷バージョンよりかなり古いため、ここにあるスクリーンショットと表示が異なる場合は、そのフィードではなくアプリ内のダウンロード情報を確認してください。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、ChatWise設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. ChatWiseで設定 → プロバイダーを開き、「+」をクリックして新しいプロバイダーを追加します。ドキュメントによると、ここからは2つの方法があります。組み込みプリセットを選ぶ方法と、カスタム設定を作成する方法です。Kunavoはプリセットにないため、後者を選んでください。
  3. 前述のとおり、プロバイダー名、API Base URL、API Keyを入力します。フォームではベンダーを選択しません。モデルIDはエンドポイントで解決されるため、OpenAI互換プロバイダーにClaudeのIDを指定するのは意図された組み合わせであり、設定の不一致ではありません。
  4. モデルの行でFetchを押します。ChatWiseのドキュメントによると、APIが/modelsエンドポイントに対応していれば、利用可能なモデルを自動で追加できます。KunavoはGET /v1/modelsを返すため、一覧が自動的に表示されます。手入力したいIDがある場合は+ 新規を使います。
  5. モデルを手動で追加する場合、ドキュメントに記載されているフィールドは次のとおりです。モデルIDはAPI識別子、表示名はラベルにすぎないため、IDはカタログと完全に一致させる必要があります。機能にチェックを入れ、コンテキスト長をモデルに合わせて設定します。これらの設定はクライアントで利用可能な機能を示すものであり、エンドポイントに動作を指示するものではありません。
  6. モデル選択欄でプロバイダーを選び、メッセージを送信します。画像モデルの場合、ChatWiseの画像生成ページによると、画像選択欄に表示するには、モデルタイプを画像に設定する手順がもう1つ必要です。

ChatWiseのカスタムプロバイダー設定ページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

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

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

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがChatWiseで機能します。

# 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 入力 / 出力ChatWiseでの位置付け
claude-sonnet-5$1.40 / $7.00日常的に使うスレッド — 1ドルあたりの品質が決め手となる長い会話
claude-opus-5$3.50 / $17.50難しい質問をするために、別のアプリを開く代わりに使うモデル
claude-haiku-4-5$0.70 / $3.50チャットクライアントが自動的に行うタイトル生成、要約、バックグラウンド呼び出し
gpt-5-6-terra$0.70 / $4.20コンテキストウィンドウが制約となる、長文の貼り付け
gpt-5-6-sol$2.00 / $12.00同じキーで利用する、別系統のモデルによるセカンドオピニオン
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト(エディターやチャットクライアントが送る内容の大半)では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

よくある質問

ChatWiseにカスタムAPIプロバイダーを追加するにはどうすればよいですか?

「設定」を開いて「プロバイダー」に移動し、「+」をクリックして新しいプロバイダーを追加します。次にプリセットを選ぶか、カスタム設定を作成します。プロバイダー名、API Base URL、API Keyを入力し、「Fetch」ボタンまたは「+ New」でモデルを追加します。ChatWise自身のカスタムプロバイダーに関するドキュメントでは、あらゆるOpenAI互換またはAnthropic互換のAIサービスを統合する方法として説明されています。したがって、ゲートウェイも正式に想定された用途であり、回避策ではありません。

ChatWiseのAPI Base URLの末尾に/v1は必要ですか?

OpenAI互換エンドポイントの場合は必要です。ChatWiseはフィールドの下に「URLに/chat/completionsを含めないでください」と表示しています。ルートはクライアント側で追加されるため、指定する値は/v1のルート、つまりhttps://api.kunavo.com/v1です。ChatWiseのドキュメントでこのフィールドに値が入力された状態を示している唯一のホスト型ゲートウェイも、https://aihubmix.com/v1という同じ形式になっています。/v1を省くと認証失敗ではなく404になるため、これが2種類の誤りを見分ける最も速い方法です。

ChatWiseでFetchしてもモデルが表示されないのはなぜですか?

モデル一覧は、入力したキーを使ってエンドポイントの/modelsルートから取得されるため、一覧が空の場合は通常、カタログが空なのではなく、キーまたはBase URLに問題があります。同じ組み合わせをアプリの外から/v1/modelsに対する通常のcurlでテストしてください。JSONが返ればプロバイダーフォームの問題、401ならキー、404ならURLが原因です。代わりに「+ 新規」でモデルを手動追加することもできます。その場合、モデルIDはカタログのIDと完全に一致させる必要があります。

ChatWiseで自分のAPIキーを使うには、サブスクリプションやライセンスが必要ですか?

この2つは別々の支払い関係です。ChatWiseは一度購入するクライアントで、モデルの利用料はキーを発行したサービスの請求に従います。Kunavoのキーを使う場合は、トークンごとにプリペイド残高から差し引かれ、月額料金はかかりません。有料プランで利用できる機能の一覧にプロバイダー設定は含まれていませんが、無料プランでカスタムプロバイダーを追加できるとは、ChatWiseのどのページにも明記されていません。利用を前提とする前に、試用期間中に確認してください。

AnthropicアカウントがなくてもChatWiseでClaudeモデルを利用できますか?

はい。OpenAI互換のプロバイダー設定を介して利用できます。モデルIDはChatWise内ではなく、設定したエンドポイントで解決されるため、使用する認証情報はそのエンドポイントのものです。これは、既存のサブスクリプションにアプリからサインインする方法とは異なります。ChatWiseはその方法も案内していますが、そちらは別のベンダーの規約に従います。自分に請求されるキーを使う方法では、そのベンダーのサブスクリプションに依存しません。KunavoではChatWiseを使ってエンドポイントを実行していないため、このページはテスト結果ではなく、設定方法の説明としてご利用ください。