ドキュメント
← すべてのドキュメント

ドキュメント

Chatbox

Chatboxではエンドポイントをホストとパスに分けており、パスは自動入力されます。そのため、ホストにはオリジンを指定します。このクライアントでは、ホストに/v1を含めてしまうのが唯一の落とし穴です。

OpenAI API Compatibleタイプのプロバイダーを追加し、API Hostにサービスルートを設定 — Chatbox自身が/v1/chat/completionsを付加します。

Chatboxの設定
Settings → Model Providers → Add

  API 提供方名称 / Provider name   Kunavo
  API 类型 / Type                 OpenAI API 兼容 (OpenAI API compatible)
  API 密钥 / API Key              sk-kn-...
  API 主机 / API Host             https://api.kunavo.com
  API 路径 / API Path             (leave empty → /v1/chat/completions)
  Model                           claude-sonnet-5
API Hostにはhttps://api.kunavo.comを指定し、/v1は含めません。ChatboxにはAPI Pathという別のフィールドがあり、既定値は/v1/chat/completionsです。そのため、ホストがすでに/v1で終わっていると、リクエスト先は/v1/v1/chat/completionsになります。別の設定が必要だと分かっている場合を除き、パスは空のままにしてください。
Chatboxのプロバイダータイプ選択欄で指定するのは、通信形式です。OpenAI API 兼容（OpenAI API互換）を選び、その後ClaudeのモデルIDを入力してください。IDはエンドポイントで解決されるため、この2つの設定は矛盾しません。
まだキーをお持ちですか？Kunavoアカウントを作成し、キーを作成します（sk-kn-で始まります）。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Chatbox設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. 設定 → モデルプロバイダーを開き、追加をクリックします。
  3. プロバイダー名を入力し、タイプにOpenAI API 互換を指定して、API Keyを貼り付けます。
  4. API Host / API Hostにhttps://api.kunavo.comを設定し、API Path / API Pathは空のままにします。
  5. 使用するモデルIDを追加して保存し、会話を開始します。

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

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

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

# 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 入力 / 出力Chatboxでの位置付け
claude-sonnet-5$1.40 / $7.00デフォルトの会話モデル
claude-haiku-4-5$0.70 / $3.50応答速度と料金の両方が重要な短いやり取り
claude-opus-5$3.50 / $17.50難しい質問用に残しておく2つ目のプロバイダー設定
gpt-5-6-terra$0.70 / $4.20同じキーで使える別系統のモデル
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト（エディターやチャットクライアントが送る内容の大半）では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

よくある質問

OpenAI互換エンドポイントを使う場合、ChatboxのAPI Hostには何を指定すればよいですか？

パスを含まないオリジンを指定します。たとえば、https://api.example.comです。ChatboxにはAPI Pathという別のフィールドがあり、既定値は/v1/chat/completionsです。ドキュメントによると、通常この欄に入力する必要はありません。つまり、/v1を指定するのはホストではなくパスです。ホストを/v1で終わらせると、リクエスト先が/v1/v1/chat/completionsになり、404エラーが発生します。

Chatboxにカスタムモデルプロバイダーを追加するにはどうすればよいですか？

「設定」→「モデルプロバイダー」を開き、「追加」をクリックします。次にプロバイダー名を入力し、OpenAI互換APIタイプを選択してAPIキーを貼り付け、API Hostにはエンドポイントのオリジンを指定し、API Pathは空のままにします。使用するモデルIDを追加して保存すると、すべての会話のモデル選択欄にそのプロバイダーが表示されます。

ChatboxでClaudeモデルを利用できますか？

はい。Claudeモデルを提供するOpenAI互換エンドポイントを介して利用できます。Chatboxは入力したモデルIDを設定済みのホストに送信するため、ClaudeのIDはChatbox内ではなく、そのエンドポイントで解決されます。アプリ用にAnthropicの認証情報を用意する必要はありません。プロバイダータイプの選択欄で指定するのは通信形式であり、ベンダーではありません。

ChatboxのAPI Pathは、どのような場合に入力すればよいですか？

エンドポイントが/v1/chat/completionsでチャット補完を提供していない場合に限ります。このフィールドは、通常と異なるルーティングを使うゲートウェイ向けです。標準的なOpenAI互換サービスでは空欄のままにするのが正しく、パスの入力は、認証の問題に見える404エラーのよくある原因です。