カスタム API の設定

Filo Plus には Filo が管理する AI サービスが含まれます。無料プランを使う場合でも、Filo Desktop に自分の AI プロバイダーやローカルモデルを接続し、自分の API 利用枠で Filo AI 機能を使い続けられます。

カスタム API は Filo Desktop の各デバイスで個別に設定します。設定したプロバイダーを使うために Filo Plus は必要ありませんが、対応モデルとプロバイダーが求める残高または課金設定が必要です。プロバイダー料金は Filo とは別に請求されます。

Filo AI の利用方法を選ぶ

Filo Plus

最も簡単な方法です。モデル、サービス、利用枠を Filo が管理するため、外部 API アカウント、キー、プロバイダー請求を管理する必要がありません。

無料プラン + カスタム API

対応プロバイダー、OpenAI 互換エンドポイント、またはローカルモデルを接続します。AI 体験は Filo が提供し、モデルと利用料金はプロバイダーが提供・請求します。

カスタム API で利用できる AI 機能

AI 要約と自動 To-do

メールやスレッドを要約し、アクション項目を見つけ、関連するメッセージを自動的に To-do に変換します。

AI 会話

メールの文脈について質問・検索・分析し、選択したモデルで Filo AI の会話機能を利用します。

AI Compose とクイック返信

新規メールや返信の下書き、文章の書き換え、送信前のトーンや表現の調整ができます。

翻訳とその他の AI 操作

AI 翻訳と、インストール済み Filo Desktop に含まれるその他のプロバイダー対応 AI ツールを利用できます。

始める前に

•Filo Desktop を最新バージョンに更新します。設定に API Configuration または Custom AI（BYOK）が表示されない場合、現在のビルドにはまだこの機能が含まれていません。
•クラウドプロバイダーでは、アカウントを作成し、必要に応じて課金または残高を有効にして API Key を発行します。ChatGPT、Claude、Gemini の一般向けサブスクリプションには通常 API 利用量は含まれません。
•必要な作業に対応するモデルを選びます。AI 会話や Agent 操作には、ツール呼び出しと十分なコンテキスト長に対応するモデルが適しています。
•ローカルプロバイダーでは、Filo で接続テストを行う前にインストール、モデルのダウンロード、ローカルサーバーの起動を完了してください。

対応するプロバイダーの種類

クラウドモデルプロバイダー

OpenAI、Anthropic、Google Gemini、DeepSeek、xAI、Qwen、Mistral、Z.AI、Doubao、Moonshot、MiniMax、Together、Fireworks、Groq、Cerebras、SambaNova、Nebius、Hugging Face。

ルーターとゲートウェイ

OpenRouter、Requesty、Vercel AI Gateway、AIHubMix などの互換ルーティングサービスでは、1 つのアカウントから複数のモデルファミリーにアクセスできます。

OpenAI-Compatible

API Base URL、API Key、正確なモデル ID を入力して、カスタム OpenAI 互換サービスを接続します。https://api.example.com/v1 のようなベース URL と、完全な /chat/completions URL の両方に対応します。

ローカルとセルフホスト

Ollama と LM Studio はこのコンピューターで実行し、API Key は不要です。LiteLLM はローカルまたはリモートで実行でき、API Key は任意です。リモート環境では HTTPS が必要です。

各フィールドの意味

Provider

Filo AI リクエストを受け取る会社またはエンドポイントを選びます。カスタム互換エンドポイントには OpenAI-Compatible を使います。

API Base URL

プロバイダー API のルートアドレスです。公式プロバイダーは通常デフォルト値のままにし、カスタムまたはセルフホスト環境では正確なアドレスを入力します。

API Key

プロバイダーが発行する秘密の認証情報で、通常のアカウントパスワードではありません。Ollama と LM Studio は不要で、LiteLLM は構成によって任意です。

Model

Filo が呼び出すモデルです。Model 一覧を提供するプロバイダーでは、完全な Agent Tool Call 機能と画像認識を含むマルチモーダル機能の両方に対応するモデルだけが表示されます。Filo がメール処理タスクを実行するには両方が必要なため、要件を満たさないモデルは選択肢に表示されません。カスタムエンドポイントでは、両方に対応するモデルを選び、必要に応じて provider/model のような名前空間を含む正確なモデル ID を入力してください。

Reasoning effort

表示される場合、Low は高速で通常は安価、High は難しい作業により多くの時間と token を使います。迷った場合は Medium が適しています。

カスタム API を手順どおりに設定する

Filo Desktop を開き、設定 → API Configuration に移動します。
プロバイダーを検索して選択します。カスタム互換サービスには OpenAI-Compatible、ローカルまたはセルフホストには Ollama、LM Studio、LiteLLM を選びます。
API Base URL を確認します。公式プロバイダーはデフォルト値が入力されています。OpenAI-Compatible ではベース URL または完全な /chat/completions URL を入力できます。リモート URL は HTTPS、Ollama と LM Studio は localhost などのループバックアドレスが必要です。
プロバイダーの API Key を貼り付けます。Ollama と LM Studio では省略し、LiteLLM では環境が要求する場合のみ入力します。
モデルを選びます。一覧が表示されない場合は、プロバイダーまたはローカルサーバーの正確なモデル ID を入力します。
Reasoning effort が表示される場合は必要に応じて選び、迷ったら Medium のままにします。
Test connection を選びます。Filo は小さな検証リクエストを送り、プロバイダーが設定を受け入れた後にのみ認証情報を保存します。
プロバイダーが Ready になったら Enable Custom AI をオンにします。
メールを開き、要約、To-do 抽出、AI 会話、下書きのいずれかを試します。Key、URL、モデルを変更した場合は、もう一度接続テストを行います。

有効にすると変わること

•Filo Desktop の対応 AI 機能は、要約、自動 To-do、AI 会話、Compose/返信ツール、翻訳を含め、選択したプロバイダーとモデルを使用します。
•設定と認証情報はこのデバイスだけに保存され、他のコンピューターやモバイルデバイスには自動同期されません。
•Enable Custom AI をオフにすると Filo 管理の AI に戻り、その利用可否は無料プランまたは Filo Plus の権利に従います。
•カスタム API のプロバイダー経由リクエストは Filo AI 利用枠を消費しませんが、無制限ではありません。プロバイダー残高、レート制限、モデル制限、地域での提供状況が適用されます。

セキュリティと料金

•認証情報はこのデバイスに安全に保存され、選択したプロバイダーのエンドポイントにだけ送信されます。
•AI 操作の実行に必要なメール本文、スレッドの文脈、下書き、添付ファイルの内容、To-do 情報がリクエストに含まれる場合があります。
•API Key や認証トークンを含むスクリーンショットやエクスポート設定を共有しないでください。
•料金、データ保持、モデル学習、処理地域、レート制限、モデル提供状況はプロバイダーが管理します。機密メールを送る前にデータポリシーを確認してください。
•可能なら専用キーを作成し、プロバイダー側で利用上限を設定してください。漏えいの可能性があれば直ちに無効化して再発行します。

トラブルシューティング

•401 または 403 は Key が拒否されたことを示します。Key が有効で、選択したプロバイダーのものであり、モデルの利用権限があることを確認してください。
•429 はレート制限または残高不足です。時間を置く、残高を追加する、上限を引き上げる、または別のモデルを選びます。
•404 は通常 Base URL またはモデル ID の誤りです。プロバイダーのドキュメントと照合し、同じパスを二重に追加していないか確認してください。
•アドレス遮断または HTTPS エラーは Filo のネットワーク安全規則を満たしていないことを示します。リモートサービスは HTTPS、Ollama と LM Studio はループバックアドレスが必要です。
•ローカル接続に失敗する場合は、サーバーの起動、ポート、モデルのダウンロード完了を確認してください。
•通常の質問は動くのに Agent 操作が失敗する場合は、ツール呼び出しとより大きなコンテキストに対応するモデルへ変更して再テストしてください。
•API Configuration が表示されない場合は Filo Desktop を更新し、そのビルドに機能が含まれているか確認してください。