主要ポイント
- Base URLはhttps://api.dolphinllm.com/v1、唯一のモデルIDはuncensoredです。
- 管理者設定の「接続」または「OpenAI API」セクションに追加するか、Docker の環境変数として渡してください。
- まず curl でテストしてください。curl が動作すれば、残りの問題は Open WebUI の設定にあります。
- $0.50 のトライアルクレジットは、数百回の通常のチャットターンに十分です。
必要な値
Open WebUI がこのサービスから必要とするのは3つのことです。1つ目は Base URL、https://api.dolphinllm.com/v1 です。2つ目はアカウントの API キーです。3つ目はモデル ID、uncensored で、接続が確立されると Open WebUI はモデル一覧から自動的に読み取ります。
関係するエンドポイントは2つです。GET /v1/models はモデルのドロップダウンを埋め、POST /v1/chat/completions は送信するすべてのメッセージを処理します。チャットにはこれ以上必要ありません。これはテキスト API であるため、Open WebUI の画像、音声、埋め込み機能には対応するものがありません。
| Open WebUI のフィールド | 内容 |
|---|---|
| API ベース URL | https://api.dolphinllm.com/v1 |
| API キー | API キーページからのキー |
| モデル | uncensored |
カードは必要ありません。サインアップ後、キーページでワンクリックで $0.50 のトライアルクレジットを取得できます。これは 7 日間有効です。
管理者パネルで接続を追加
Open WebUI がすでに実行中の場合、これが最速の方法です。
- 管理者としてログインし、管理者設定、次に接続を開きます。
- OpenAI API セクションで、プラスボタンをクリックして接続を追加します。
- URL として
https://api.dolphinllm.com/v1を貼り付け、キーとしてあなたのキーを入力してください。 - フィールドの横にある検証ボタンを使用します。緑色の確認メッセージは、モデルリストが返されたことを意味します。
- 保存し、新しいチャットを開き、モデルセレクタから
uncensoredを選択します。
Open WebUI のバージョンによってメニュー名が少し異なる場合があります。接続が見つからない場合は、設定で「OpenAI」を検索してください。フィールドは常に同じです：URL、キー、および場合によってはモデルフィルター。
Docker 環境変数で設定
新規インストールの場合、管理者画面をスキップして、コンテナ起動時に接続を渡すことができます。Open WebUI は起動時に OPENAI_API_BASE_URL と OPENAI_API_KEY を読み取ります。
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL="https://api.dolphinllm.com/v1" \
-e OPENAI_API_KEY="YOUR_KEY" \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main次に http://localhost:3000 にアクセスし、最初のアカウントを作成（これが管理者になります）すると、モデルがすでにリストされているはずです。マシンが共有される場合は、キーをシェル履歴から外してください：env ファイルに配置し、代わりに --env-file を使用します。
一部の Open WebUI バージョンでは、これらの変数は初期値としてのみ扱われます。UI で接続を保存すると、保存された値が優先されます。変数を変更しても何も起こらない場合は、管理者設定で接続を編集してください。
複数人での利用
Open WebUI には独自のユーザーアカウントがあるため、1 つのインストールで家庭や小規模チームにサービスを提供でき、サーバーには 1 つの API キーのみが存在します。これは便利ですがリスクでもあります：すべてのユーザーが同じ残高から消費します。誰にアカウントを与えるかを決め、X-Balance-USD を定期的に確認してください。そうすれば、ロールプレイの長い週末でも驚かされません。
キーは環境変数またはシークレットファイルに保存し、スクリーンショットや共有ドキュメントには入れないでください。キーは API キーページ にあります。キーが漏洩したと思われる場合は、新しいキーを取得した直後に Open WebUI で置き換えてください。公開向けインストールの場合は、HTTPS の背後に配置し、誰でもサインアップできる設定をオフにして、見知らぬ人がアカウントを作成してあなたのクレジットを使用できないようにしてください。
共有セットアップのもう 1 つのポイント：このモデルは、法的な成人用途に対してコンテンツ拒否なしで回答するようにチューニングされています。これはフィクションやプライベートな研究のための機能であり、つまりあなたはハウスルールを決定します。共有モデル上のシステムプロンプトがそれを書く最も簡単な場所です。プロンプトが何であっても、API では未成年者を含む性的な行為は許可されていません。
このセットアップの適切な用途
Open WebUI を無検閲エンドポイントに接続する人々は通常、ホストされたチャットボットの制限のないクリーンなチャットウィンドウを望んでいます。一般的な用途には、長編小説や世界観構築、成人向けのロールプレイや相棒キャラクター、メインストリームのアシスタントが触れることを拒む素材のドラフト、そして通常のコーディングやライティングヘルプが含まれます。同じモデルがこれらすべてを処理するため、1 つのチャット内でタスクを切り替えることができます。
Open WebUI はいくつかの特定の点で役立ちます。保存されたプロンプトとモデルプリセットにより、キャラクターや編集者ペルソナをワンクリックで保持できます。有効にした場合のドキュメントアップロードやウェブ検索機能は、追加テキストをプロンプトに送信するため、トークン使用量が増加します。そのため、添付するファイルのサイズには注意してください。チャットフォルダと検索により、長いプロジェクトに戻りやすくなります。
この接続からは、画像、音声、ビデオの生成は行われません。API はテキストのみであるためです。
Open WebUI のせいにする前にエンドポイントをテスト
セットアップの失敗の多くは URL のタイプミスまたは期限切れのキーによるもので、どちらもターミナルでより早く確認できます。Open WebUI をホストしているマシンからこれらの 2 つの呼び出しを実行してください。
curl https://api.dolphinllm.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
curl https://api.dolphinllm.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in five words."}]
}'最初の呼び出しでは uncensored がリストされるはずです。2回目の呼び出しでは通常のチャット完了レスポンスが返されるはずです。レスポンスヘッダーも確認してください：X-Balance-USD にはアカウントの残高が表示され、Open WebUI があなたが想定しているキーからクレジットを使用していることを確認する便利な方法となります。
完全なパラメータリストは API ドキュメント にあります。
チャット向けに変更する価値のある設定
システムプロンプトとサンプリング
Open WebUI はモデルごとまたはチャットごとにシステムプロンプトを設定できます。このモデルは法的な成人用途に対してコンテンツ拒否なしで回答するようにチューニングされているため、トーン、ペルソナ、または出力形式を固定する短いシステムプロンプトは、長いルールリストよりも効果的です。Temperature、top_p、stop、seed、ペナルティは渡されるため、Open WebUI のスライダーには効果があります。
コンテキストの長さ
ウィンドウはプロンプトと完了を合わせて 100,000 トークンです。長いチャットはターンごとにプロンプトを成長させ、あなたは毎回履歴全体に対して課金されます。スレッドが重くなったら、新しいチャットを開始するか、古いチャットを要約してください。
背景リクエスト
Open WebUI はチャットのタイトルやタグのためにバックグラウンドで追加の呼び出しを送信できます。デフォルトでは同じモデルを使用します。トライアルキーでは同時リクエストが 2 件、1 分あたり 60 件までしか許可されないため、これらの呼び出しが実際のメッセージを圧迫する可能性があります。タイトルとタグの生成をオフにするか、短い遅延を受け入れます。フルキーでは同時リクエストが 8 件、1 分あたり 300 件まで許可され、個人用または小規模チームのインストールには十分です。
ストリーミング、JSON モード、ツール
Open WebUI はデフォルトで返信をストリーミングし、API はサーバー送信イベント（stream: true）をサポートし、ストリームの最後に使用量ブロックがあります。テキストはトークンごとに現れ、最終レスポンスの残高ヘッダーはあなたが消費した金額を反映します。
ツール呼び出しも API でサポートされています：tools、tool_choice、ストリーミングされた tool_calls、および role: "tool" として返される結果。Open WebUI がこれをどの程度公開するかは、そのバージョンとインストールするツールや関数に依存するため、ワークフローを構築する前に小さなツールでテストしてください。JSON モード（response_format を json_object に設定）は、チャット UI の隣でスクリプトから同じエンドポイントを呼び出す場合に役立ちます。
実用的なパターンは、Open WebUI を人々のために使用し、バッチ作業には同じキーをスクリプトから使用することです。両方とも同じベース URL を通じるため、1 つの残高がすべてをカバーします。ただし、制限はキーごとに適用されることを忘れないでください：フルキーでは同時リクエストが 8 件で、UI とスクリプト間で共有されます。
一般的なエラーと修正
- モデルが表示されない。 URL におそらく
/v1が不足しているか、タイプミスがあります。上記の値と文字ごとに比較し、末尾の斜線を削除してください。 - 認証エラー。 キーに先頭または末尾のスペースが含まれて貼り付けられたか、削除されたアカウントに属しています。キーページから再度コピーしてください。
- モデルセレクタに間違ったリストが表示される。 Open WebUI はローカル Ollama などの他の接続も照会します。使用しないものを無効にしてください。
- ストリーミング中に返信が途切れることがあります。 Open WebUI の前面にあるリバースプロキシが、サーバー送信イベントをバッファリングしている可能性があります。そのルートのバッファリングを無効にしてください。
- 残高が不足します。 残高がゼロになる前にチャージしてください。失敗または拒否されたリクエストは課金されません。配信された補完結果に対してのみ課金されます。
チャット UI のコスト
料金は、前払いクレジットから、入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50です。中程度のチャットの典型的なターンを想定します：4,000トークンの履歴が入力され、500トークンが出力されます。入力のコストは 4,000 x $0.15 / 1,000,000 = $0.0006 です。出力のコストは 500 x $0.50 / 1,000,000 = $0.00025 です。このターンのコストは $0.00085 です。
そのレートでは、$0.50 のトライアルクレジットは約 588 ターン分をカバーし、$20 のチャージで約 23,500 ターン分をカバーできます。チャージボーナスについては 価格ページ を参照してください。Open WebUI 以外、例えばログイン画面を必要としないスクリプトなどで同じキーを使用したい場合は、ログイン制限なしで LLM を使用する のページでその方法を確認できます。
