自定义 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 兼容接口或本地模型。Filo 提供完整的 AI 使用体验，模型与用量由你的服务商提供和计费。

自定义 API 可以继续使用的 AI 功能

AI 摘要与自动待办

总结单封邮件或完整会话，识别行动项，并自动把相关邮件转成待办。

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 等兼容路由服务，可通过一个账户访问一个或多个模型系列。

OpenAI-Compatible

填写 API Base URL、API Key 和准确的模型 ID，即可连接自定义 OpenAI 兼容服务。支持 https://api.example.com/v1 这样的基础地址，也支持完整的 /chat/completions 地址。

本地与自托管

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 列表的服务商，Filo 只会显示同时支持完整 Agent Tool Call 能力和多模态图片识别的模型。Filo 需要这两项能力才能参与邮件处理任务，因此不满足要求的模型不会出现在可选列表中。使用自定义接口时，请选择同时具备这两项能力的模型，并准确填写模型 ID；服务商要求时需包含 provider/model 这样的命名空间。

Reasoning effort

显示此选项时，Low 更快且通常更省费用，High 会为复杂任务使用更多思考时间和 token；不确定时保留 Medium。

分步设置自定义 API

打开 Filo Desktop，前往设置 → API Configuration。
搜索并选择服务商。自定义兼容服务请选择 OpenAI-Compatible；本地或自托管方案请选择 Ollama、LM Studio 或 LiteLLM。
检查 API Base URL。官方服务商会预填默认地址；OpenAI-Compatible 可填写基础地址或完整 /chat/completions 地址。远程地址必须使用 HTTPS；Ollama 与 LM Studio 必须使用 localhost 或其他回环地址。
粘贴服务商生成的 API Key。Ollama 与 LM Studio 可跳过；LiteLLM 仅在你的部署要求时填写。
选择模型。如果没有模型列表，请填写服务商或本地服务返回的准确模型 ID。
如果显示 Reasoning effort，可按需要选择；不确定时保留 Medium。
点击 Test connection。Filo 会发送一个很小的验证请求，并且只会在服务商接受配置后保存凭证。
服务商状态显示 Ready 后，开启 Enable Custom AI。
打开一封邮件，测试摘要、待办提取、AI 对话或邮件草稿。以后修改 Key、URL 或模型时，需要重新测试连接。

开启后会发生什么

•Filo Desktop 中支持的 AI 功能会使用所选服务商和模型，包括摘要、自动待办、AI 对话、Compose/回复工具和翻译。
•设置与凭证只保存在当前设备，不会自动同步到其他电脑或移动设备。
•关闭 Enable Custom AI 后，Filo 会切回由 Filo 管理的 AI 服务；此时可用性取决于你的免费版或 Filo Plus 权益。
•自定义 API 请求不消耗 Filo AI 额度，但并不等于无限使用；仍受服务商余额、速率限制、模型限制和地区可用性影响。

安全与计费

•凭证会安全地保存在当前设备，只发送给你选择的服务商接口。
•为了完成 AI 操作，请求可能包含所需的邮件正文、会话上下文、草稿、附件内容或待办信息。
•不要分享包含 API Key 或授权令牌的截图或导出配置。
•价格、数据保留、模型训练、处理地区、速率限制和模型可用性由服务商决定。处理敏感邮件前，请先阅读服务商的数据政策。
•建议使用单独的 API Key，在服务商后台设置消费上限；如果怀疑密钥泄露，请立即停用并重新生成。

问题排查

•出现 401 或 403 表示 Key 被拒绝。请确认 Key 仍然有效、属于当前服务商，并且有权限使用所选模型。
•出现 429 表示达到服务商速率限制或余额不足。请稍后重试、充值、提高服务商限额或更换模型。
•出现 404 通常表示 Base URL 或模型 ID 有误。请对照服务商文档，并避免把相同路径重复拼接。
•如果提示地址被阻止或 HTTPS 错误，说明接口不符合 Filo 的网络安全规则。远程服务必须使用 HTTPS；Ollama 与 LM Studio 必须使用回环地址。
•本地连接失败时，请确认本地服务已经启动、端口正确，并且模型已经下载完成。
•如果普通提问可用但 Agent 操作失败，请换用支持工具调用且上下文窗口更大的模型，然后重新测试。
•如果没有 API Configuration 入口，请更新 Filo Desktop，并确认当前版本是否包含该功能。