Open WebUI

Open WebUI は、完全オフライン動作をサポートする、機能豊富なセルフホスト型 AI プラットフォームです。APIYI を通じて、Open WebUI にさまざまな主要な大規模言語モデルを統合できます。

クイックデプロイ

Docker クイックスタート

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

Docker Compose デプロイ

version: '3.6'

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    environment:
      - OPENAI_API_BASE_URL=https://api.apiyi.com
      - OPENAI_API_KEY=Your APIYI key
    restart: unless-stopped

volumes:
  open-webui:

APIYI の設定

方法1: 環境変数による設定

デプロイ時に環境変数を設定します:

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.apiyi.com \
  -e OPENAI_API_KEY=Your APIYI key \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

方法2: インターフェースによる設定

Open WebUI の管理画面にアクセスします
設定 > 接続に移動します
OpenAI API セクションで設定します:
- API Base URL: https://api.apiyi.com/v1
- API Key: APIYI のキーを入力します
設定を保存します

設定のポイント

API Base URL には /v1 サフィックスを含める必要があります
API Key は APIYI Console から取得できます
管理と更新を容易にするため、環境変数による方法の使用を推奨します

対応モデル

Open WebUI は APIYI を通じて以下のモデルシリーズをサポートしています。

推奨モデル

モデルシリーズ	モデル ID	機能
GPT-4 Turbo	`gpt-4-turbo-2024-04-09`	最新の GPT-4、バランスの取れた性能
Claude Sonnet	`claude-sonnet-4-20250514`	長文処理、創作的な文章作成
Gemini Pro	`gemini-2.5-pro`	マルチモーダル機能、高速応答
GPT-3.5 Turbo	`gpt-3.5-turbo`	経済的で実用的、日常会話向け

機能別注目モデル

機能	推奨モデル	説明
Vision Understanding	`gpt-4-vision-preview`	画像の分析と理解
Code Generation	`gpt-4-turbo`	プログラミング支援とコード最適化
Reasoning Thinking	`claude-sonnet-4-20250514-thinking`	思考プロセスを表示します

コア機能

RAG（Retrieval-Augmented Generation）

Open WebUI は、ドキュメントのアップロードとナレッジベース機能をサポートしています。

ドキュメントのアップロード
- PDF、TXT、DOCX などの形式に対応しています
- 自動ベクトル化して保存できます
- 多言語ドキュメントに対応しています
ナレッジベース管理
- 専用のナレッジベースを作成できます
- ドキュメントの分類とタグ付けができます
- インテリジェントな検索マッチングに対応しています

OpenAI 互換API

Open WebUI は、完全なOpenAI互換APIを提供しています。

# Chat completion
curl -X POST "http://localhost:3000/api/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer Your APIYI key" \
  -d '{
    "model": "gpt-4-turbo",
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

ツール連携

外部ツールとプラグインに対応しています:

Web検索
コード実行
画像生成
ドキュメント処理

詳細設定

複数モデルの設定

docker-compose.ymlで複数のモデルソースを設定します:

environment:
  - OPENAI_API_BASE_URL=https://api.apiyi.com
  - OPENAI_API_KEY=Your APIYI key
  - ENABLE_OPENAI_API=true
  - ENABLE_OLLAMA_API=false

ユーザー権限の管理

environment:
  - ENABLE_SIGNUP=false
  - DEFAULT_USER_ROLE=user
  - WEBHOOK_URL=Your webhook address

データの永続化

volumes:
  - open-webui:/app/backend/data
  - ./uploads:/app/backend/data/uploads
  - ./vector_db:/app/backend/data/vector_db

API統合例

Python連携

import requests

# Open WebUI API endpoint
api_url = "http://localhost:3000/api/chat/completions"

# Request configuration
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer Your APIYI key"
}

data = {
    "model": "gpt-4-turbo",
    "messages": [
        {"role": "user", "content": "Explain the basic principles of quantum computing"}
    ],
    "stream": False
}

# Send request
response = requests.post(api_url, headers=headers, json=data)
result = response.json()
print(result["choices"][0]["message"]["content"])

JavaScript連携

const apiUrl = 'http://localhost:3000/api/chat/completions';

const requestData = {
  model: 'gpt-4-turbo',
  messages: [
    { role: 'user', content: 'Write a simple Python function' }
  ]
};

fetch(apiUrl, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer Your APIYI key'
  },
  body: JSON.stringify(requestData)
})
.then(response => response.json())
.then(data => {
  console.log(data.choices[0].message.content);
});

トラブルシューティング

よくある問題

接続に失敗しました

API Base URL が正しいか確認してください: https://api.apiyi.com/v1
API Key の有効性を確認してください
ファイアウォール設定を確認してください

モデルを利用できません

アカウント残高を確認してください
モデルがサービス対象範囲内か確認してください
APIYI のサービス状況を確認してください

アップロードに失敗しました

ファイル形式のサポートを確認してください
十分なストレージ容量があるか確認してください
ファイルサイズ制限を確認してください

ログのデバッグ

デバッグモードを有効にします:

docker logs -f open-webui

詳細ログを表示します:

environment:
  - LOG_LEVEL=DEBUG
  - WEBUI_DEBUG=true

ベストプラクティス

パフォーマンス最適化

モデル選択
- 日常的な会話には GPT-3.5 Turbo を使用する
- 複雑なタスクには GPT-4 Turbo を使用する
- 長文処理には Claude Sonnet を使用する
キャッシュ戦略
- 会話キャッシュを有効にする
- 適切なキャッシュ有効期限を設定する
- 未使用キャッシュを定期的に削除する
リソース管理
- メモリ使用量を監視する
- 適切な同時実行数の上限を設定する
- ユーザーデータを定期的にバックアップする

セキュリティ設定

environment:
  - ENABLE_ADMIN_EXPORT=false
  - ENABLE_ADMIN_CHAT_ACCESS=false
  - JWT_EXPIRES_IN=7d

監視アラート

監視システムを統合してください:

environment:
  - ENABLE_WEBHOOKS=true
  - WEBHOOK_URL=https://your-monitoring-url

さらにヘルプが必要ですか？ Open WebUI 公式ドキュメントを確認するか、APIYI 公式サイトをご覧ください。

概要

対話AI

プログラミング

コミュニティ投稿

AIエージェント

エンジニアリング

翻訳

クイックデプロイ

Docker クイックスタート

Docker Compose デプロイ

APIYI の設定

方法1: 環境変数による設定

方法2: インターフェースによる設定

対応モデル

推奨モデル

機能別注目モデル

コア機能

RAG（Retrieval-Augmented Generation）

OpenAI 互換API

ツール連携

詳細設定

複数モデルの設定

ユーザー権限の管理

データの永続化

API統合例

Python連携

JavaScript連携

トラブルシューティング

よくある問題

ログのデバッグ

ベストプラクティス

パフォーマンス最適化

セキュリティ設定

監視アラート

​クイックデプロイ

​Docker クイックスタート

​Docker Compose デプロイ

​APIYI の設定

​方法1: 環境変数による設定

​方法2: インターフェースによる設定

​対応モデル

​推奨モデル

​機能別注目モデル

​コア機能

​RAG（Retrieval-Augmented Generation）

​OpenAI 互換API

​ツール連携

​詳細設定

​複数モデルの設定

​ユーザー権限の管理

​データの永続化

​API統合例

​Python連携

​JavaScript連携

​トラブルシューティング

​よくある問題

​ログのデバッグ

​ベストプラクティス

​パフォーマンス最適化

​セキュリティ設定

​監視アラート

クイックデプロイ

Docker クイックスタート

Docker Compose デプロイ

APIYI の設定

方法1: 環境変数による設定

方法2: インターフェースによる設定

対応モデル

推奨モデル

機能別注目モデル

コア機能

RAG（Retrieval-Augmented Generation）

OpenAI 互換API

ツール連携

詳細設定

複数モデルの設定

ユーザー権限の管理

データの永続化

API統合例

Python連携

JavaScript連携

トラブルシューティング

よくある問題

ログのデバッグ

ベストプラクティス

パフォーマンス最適化

セキュリティ設定

監視アラート