WorkBuddy

HopBase を WorkBuddy の OpenAI 互換モデルプロバイダーとして使います。

WorkBuddy は OpenAI 互換エンドポイントを基盤のモデルバックエンドとして呼び出せるため、HopBase がその背後のモデルを提供できます。

設定をワンステップで生成する（推奨）

チャット系グループのキーを貼り付けると、ジェネレーターがそのキーで GET /v1/models を呼び、WorkBuddy で使えるモデルを一覧にして、設定ファイルを書き込むコマンドを生成します。モデル ID は完全一致が必要ですが、キーから読み取るので打ち間違いが起きません。

設定ファイルは ~/.workbuddy/models.json、Windows では %USERPROFILE%\.workbuddy\models.json です。WorkBuddy が自動で再読み込みするため、書き込み後すぐにモデルのドロップダウンに新しいモデルが表示されます。

コマンドはファイルを丸ごと置き換え、元のファイルを先に models.json.bak-<日時> としてバックアップします。手動でモデルを追加していた場合は、バックアップから該当エントリをコピーし直してください。

画面で手動入力する

設定項目	値
プロトコル / プロバイダータイプ	OpenAI（Chat Completions）
API アドレス / Base URL	`https://api.hop-base.com/v1`
API キー	チャットモデルグループのキー
モデル	そのキーで `GET /v1/models` を呼んだ際に返される正確な ID

設定画面には Base URL を入力すれば十分です。models.json を直接編集する場合、url には完全なエンドポイントが必要です。

https://api.hop-base.com/v1/chat/completions

本番環境で検証済み：WorkBuddy は POST /v1/chat/completions にリクエストし、ストリーミングも正常に動作します。

チャットに対応したキーを選ぶ

コンソールにサインインし、GPT / Codex、GLM、Kimi K3、DeepSeek、Qwen、Grok など、OpenAI プロトコルのチャットモデルを提供するグループのキーを使用します。

正確なモデル ID を確認する

curl https://api.hop-base.com/v1/models \
  -H "Authorization: Bearer sk-your-key"

レスポンスから ID をそのままコピーします。

プロバイダーを入力する

WorkBuddy のモデルプロバイダー設定で OpenAI 互換タイプを選び、上記の Base URL、キー、モデル ID を入力します。

テストメッセージを送信する

一言だけの返信を依頼します。往復が成功すれば、キー、グループ、プロトコル、モデル ID がすべて正しく対応していることが確認できます。

よくあるエラー

エラー	原因	対処
`route_not_found`	キーが画像・動画グループのもので、チャットのエンドポイントがない	チャットモデルグループのキーを使う
`404 model_not_found`	モデル ID を `glm` のように省略している	`glm-5.3` のような完全な ID を使う

Kling、Seedance、MiniMax、Wan / HappyHorse などのグループはタスク形式のメディアエンドポイントを提供しており、chat/completions は提供していません。モデル ID にはバージョンや日付が含まれるため、必ず GET /v1/models からコピーしてください。

サードパーティクライアント — Cherry Studio、NextChat、LobeChat も同じ設定です
利用可能なモデル — 各プランが提供するモデル
トラブルシューティング — エラーメッセージから対処法を探す

設定をワンステップで生成する（推奨）

画面で手動入力する

チャットに対応したキーを選ぶ

正確なモデル ID を確認する

プロバイダーを入力する

テストメッセージを送信する

よくあるエラー

Claude モデルについて

長いシステムプロンプト

次のステップ

このページの内容