セルフホスト型サイトモデル同期 (Model Sync)

自社運用の管理パネル（New API, AxonHub, Octopus など）管理者向けの自動化ツールです。上流プロバイダーから最新のモデルリストを自動的に取得し、チャネル設定を更新することで、同期の手間を省きます。

モデルリスト同期インターフェース

機能の概要

🔄 クロスプラットフォーム自動同期: New API、AxonHub、Octopus など複数のシステムをサポートし、設定した間隔で自動的に同期を実行します。
🎯 柔軟な同期戦略: 全同期、手動でのチャネル選択同期、または前回の失敗タスクのみのリトライをサポートします。
⚡ インテリジェントな流量制限保護: 流量制限アルゴリズムを内蔵しており、数十から数百のチャネルを一括同期する際も、上流サイトから攻撃と判定されるのを防ぎます。
📊 リアルタイムの進捗監視: 同期プロセス中、各チャネルの同期ステータス、HTTP ステータスコード、および所要時間をリアルタイムで確認できます。
📜 詳細な実行履歴: 各同期の結果を保持し、同期前後のモデルリストの変化を比較できるため、追跡が容易です。

システムタイプ	同期ロジック
New API / DoneHub / Veloera	`/api/channel/fetch_models` (GET) を呼び出して上流モデルを取得し、チャネル設定を更新します。
Octopus	`/api/v1/channel/fetch-model` (POST) を呼び出して上流モデルを取得します。
AxonHub	AxonHub 管理インターフェースを介して、チャネルに関連付けられたモデルリストを自動的に読み取り、同期します。

同期を開始する前に、 基本設定 -> セルフホスト型サイト管理 で対応するシステムの接続設定（Base URL、管理者トークン、またはアカウントパスワード）を完了する必要があります。

ヒント

設定が完了したら、設定ページで 「モデルリスト同期」 を選択してタスク管理インターフェースにアクセスしてください。

「モデル同期」ページでは、以下の操作が可能です。

同期テーブルには、以下の主要なフィールドが表示されます。

設定 -> モデルリスト同期 パネルで、同期動作をカスタマイズできます。

設定項目	推奨値	説明
実行間隔	6 - 12 時間	自動同期の時間頻度です。頻繁に設定しすぎることはお勧めしません。
同時実行数	1 - 3	同時に実行される同期タスクの数です。チャネル数が多い場合は 2 以内に抑えることをお勧めします。
レート制限 (RPM)	20	上流サイトを保護するために、1 分間に許可される最大リクエスト数です。
最大リトライ回数	3	タスク失敗時の自動リトライ回数です。

質問	解決策
同期後にモデルリストが変化しない	上流サイトで実際にモデルが更新されているか、またはそのチャネルの API キーにモデルリストを読み取る権限があるか確認してください。
429 エラーが頻繁に発生する	「1 分あたりのリクエスト数」を減らすか、「実行間隔」を長くしてください。
AxonHub のモデルを取得できない	AxonHub の管理者アカウントに十分な権限があること、および Base URL が正しく入力されていることを確認してください。
同期によって一部のモデルが失われた	デフォルトでは、同期によって既存のモデルリストが上書きされます。カスタムモデル（上流から返されないモデル）がある場合は、同期後に手動で追加するか、ホワイトリスト戦略 (Beta) を使用してください。