ホーム → ガイド → Chatbox でカスタム API を使う:ホスト、パス、Claude、画像生成

Chatbox でカスタム API を使う:ホスト、パス、Claude、画像生成

Chatbox でカスタム API がつまずく場所は三つあります。APIホストと APIパスの組み合わせ、Claude Code とは逆に /v1 が必要な Claude モード、そしてカスタムプロバイダーを一切使わない画像生成です。Chatbox 1.23.5 のソースを読み、すべての組み合わせを当ゲートウェイで試し、実際の Chatbox ユーザーが出したエラーをまとめました。

プロバイダーを追加する

  1. 設定 → モデルプロバイダーを開き、カスタムプロバイダーを追加をクリック。名前を付け、APIモードは OpenAI API互換 を選びます。
  2. APIホストに https://apiclan.us を入力し、APIパスは空のままにします。
  3. コンソールの API キーを貼り付けます。
  4. 取得でキーのグループのモデルを読み込み、確認でキーが使えるか確かめます。
APIホストAPIパスChatbox が呼ぶ URL
https://apiclan.us(空)/v1/chat/completions ✓
https://apiclan.us/v1/chat/completions/v1/chat/completions ✓
https://apiclan.us/chat/completions/chat/completions ✗ 404

Chatbox がホストに /v1 を足すのは APIパスが空のときだけです。パスを入力するとホストはそのまま使われるため、https://apiclan.us に /chat/completions を組み合わせると /v1 が抜け、本文が空の 404 になります。パスを空にするか、ホストに /v1 を含めてください。

Claude を追加する

方法は二つあり、アドレスのルールが異なります:

APIモードAPIホストChatbox が呼ぶ URL
OpenAI API互換https://apiclan.us/v1/chat/completions ✓
Claude API互換https://apiclan.us/v1/v1/messages ✓
Claude API互換https://apiclan.us/messages ✗ 404

いちばん簡単なのは、OpenAI API互換モードのカスタムプロバイダーをもう一つ作り、Claude グループのキーを入れる方法です。記録した Chatbox リクエスト 43 件のうち 29 件が、この方法で送られた claude-fable-5-1 でした。Claude API互換モードを使うなら、Chatbox は /messages しか付けないので、ホストは /v1 で終わる必要があります。これは Claude Code と逆で、そちらの ANTHROPIC_BASE_URL には /v1 を含めてはいけません。

Chatbox で画像を生成する

画像生成に表示されるのは内蔵の OpenAI プロバイダー(と Chatbox 自身、Gemini)だけです。カスタムプロバイダーは画像モデルを返さないようコードで固定されているため、選ぶと Provider doesnt support image generation で失敗します。

  1. 設定 → モデルプロバイダー → OpenAI を開きます(自分で追加したカスタムプロバイダーではなく内蔵のもの)。
  2. APIホストを https://api.apiclan.us にし、画像グループで作成したキーを貼り付けます。
  3. モデル gpt-image-2.5 を追加し、モデルタイプを画像にします。
  4. 画像生成を開き、gpt-image-2.5 を選びます。

チャット用モデルはカスタムプロバイダーに残してください。キーは一つのグループに属するため、内蔵 OpenAI プロバイダーの画像用キーでは GPT のチャットモデルを動かせません。ここで api.apiclan.us を使うのは、大きな画像は数分かかることがあり、メインのアドレスは 100 秒で応答を切るためです。Chatbox と同じ形式のテストでは、1024×1024 の画像が 21 秒で返りました。

実際の Chatbox リクエストのコスト

2026 年 10 月 12 日までの 30 日間に当ゲートウェイが受けた Chatbox リクエスト 43 件すべて。いずれも /v1/chat/completions へのストリーミングです:

モデルリクエスト数最初のトークン(中央値)1 メッセージ平均
claude-fable-5-1295.2 s$0.039
gpt-6-astra81.4 s$0.006
gpt-5.6-sol67.6 s$0.004

ここでは Claude の返信が GPT の約 7 倍のコストでした。主な理由は回答が長いこと(出力平均 622 トークン)です。Chatbox は毎ターン会話全体を送り直しますが、Claude ではリクエストあたり平均 4,071 トークンが通常の入力ではなくキャッシュ読み取りとして課金され、長い会話でも費用が膨らみにくくなっています。gpt-5.6-sol は最も安い一方、回答前に推論するため最初のトークンが最も遅くなりました。

実際の Chatbox ユーザーが出したエラー

ほかのデスクトップクライアント: Cherry Studio でカスタム API を使う · Claude Code の base URL.

使い始める

サブスクリプションなし、月額の最低利用額なし、営業との商談も不要。USDT でチャージして使った分だけお支払いください — 1 USDT で 2 クレジットの API 残高になります。

30秒のクイックスタートを読む

言語: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

このページの価格は実際の課金データから自動で反映しています。第三者の条件は各社の公開ドキュメントから引用しています。