LangBotは、外部サービスと統合・自動管理するための RESTful API を提供します。これらのAPIはAPIキーで認証され、HTTP APIのサブセットです。
Service APIは現在ベータ版であり、一部のAPIは頻繁に変更される可能性があります。
APIキーの取得
WebUIのサイドバーにある API Keys ボタンをクリックして、APIキーを作成します。
作成後、APIキーをコピーして保存します。
認証方法
すべてのService APIは、以下の2つの認証方法をサポートしています：
- APIキー:
X-API-Key: <your-key> または Authorization: Bearer <your-key> ヘッダー経由
- ユーザートークン:
Authorization: Bearer <user-token> ヘッダー経由（ログイン後に取得）
APIの使用
左サイドバーには、利用可能なすべてのAPIが一覧表示されています。インスタンスアドレス（デフォルトは http://localhost:5300）とAPIキーを入力し、Try it out ボタンをクリックしてAPIを呼び出せます。
コアコンセプト
Provider + Model アーキテクチャ
LangBotは プロバイダー（Provider）+ モデル（Model） の2層アーキテクチャでAIモデルを管理します：
- プロバイダー: APIエンドポイント（
base_url）、リクエスタータイプ、APIキーを定義。1つのプロバイダーに複数のモデルを関連付け可能。
- モデル: プロバイダーに関連付け（
provider_uuid 経由）、具体的なモデル名とパラメータを定義。プロバイダーのAPIエンドポイントとキーを継承。
Provider (OpenAI)
├── base_url: https://api.openai.com/v1
├── api_keys: [sk-xxx]
├── LLM: gpt-4o
├── LLM: gpt-4o-mini
└── Embedding: text-embedding-3-small
リクエスター
リクエスターはAIサービスとの通信プロトコルを定義します。GET /api/v1/provider/requesters で利用可能なリクエスター一覧を取得できます。
非同期タスク
一部の操作（プラグインのインストール/削除/アップグレード）は非同期で実行され、task_id を返します。WebUIで進捗を確認できます。 