本文档由英文原版机器翻译而成。如果翻译版本与英文原版之间存在任何冲突，请以英文原版为准。 阅读英文原版

AI 提供商和 API 密钥

Caiioo 通过一小部分提供商连接到 500 多种 AI 模型。您自备 API 密钥 —— 这意味着您直接向提供商付费，Caiioo 绝不触碰您的支出。

支持的提供商

目前在 Settings > AI Setup > AI Provider 中提供了 11 种云端和本地提供商：

  • OpenRouter（默认）— 单个 key 即可解锁 500+ 个模型，包括 Anthropic Claude、Google Gemini、OpenAI GPT、Mistral、Groq、Llama、DeepSeek、Qwen 等。这是适合大多数用户的推荐途径 —— Caiioo 的工具依赖 OpenRouter 的模型注册表，并且您只需管理一个 key。
  • Google AI — 使用您自己的 Google AI key 直连 Gemini API。Google 提供了真正的免费额度，因此这是一种无需信用卡即可运行前沿模型的真正途径 —— 具备原生思考能力以及高达 2M 的上下文窗口。Settings 会指导您获取免费 key。
  • Anthropic — 使用您自己的 Anthropic key 直连 Claude API，支持原生扩展思考与工具调用。在 console.anthropic.com 创建 key，或在您授权访问 Claude 账户后由 Caiioo 为您创建。账单将计入您的 Anthropic Console 账户；Caiioo 不会保留用于创建该 key 的 Claude 登录信息。Anthropic 不允许在其他应用中使用 Claude Pro 或 Max 订阅，因此 Caiioo 中的 Claude 运行在 Console key 或通过 OpenRouter 运行，而非使用您的订阅。
  • xAI (Grok) — 通过 api.x.ai 直接访问 Grok 模型。可使用 xAI 控制台 API key 进行连接，或使用您的 Grok 账户登录（SuperGrok 或 X Premium+ 订阅）—— 在浏览器中批准访问权限后即可完成连接，无需复制 key。注意：xAI 在其服务端按账户和订阅层级开启 API 访问权限；如果连接后聊天因权限错误而失败，请改用 xAI API key。
  • OpenAI — 使用您自己的 OpenAI API key 直连 OpenAI 模型，或使用您的 ChatGPT 账户登录，Caiioo 将使用您的 ChatGPT 订阅运行而非 key。
  • CometAPI — 通过一个按需付费的 CometAPI key 即可使用 500+ 个模型（GPT、Claude、Gemini、DeepSeek 等）。模型选择器会为其目录显示基准评测层级的勋章，且 CometAPI 的总使用量会在 Settings 中进行跟踪。
  • Poe — 通过一个 Poe API key 即可使用来自 Anthropic、Google、OpenAI、xAI、Meta 等的模型，费用按您的 Poe 订阅积分扣除，而非按 token 美元计费。您的剩余积分余额和对话所消耗的积分均会在应用中显示。请在 poe.com/api/keys 获取 key。
  • Ollama — 在您的本地机器上运行开源模型（默认地址为 http://localhost:11434）。私密、无需联网且完全免费。Ollama Cloud 也可通过可选的 API key 配合使用。
  • vLLM、Unsloth 与 MLX (Pro) — 连接运行 vLLM（默认 http://localhost:8000）、Unsloth（默认 http://localhost:8000）或 MLX（在 Apple Silicon 上默认 http://localhost:8080）的本地或网络中兼容 OpenAI 的推理服务器，支持可选的 bearer token。当您从手机或浏览器进入由桌面端托管的对话时，Caiioo 会自动列出并运行该桌面本地服务器上的模型。

有关政策，请参见使用条款。

开始使用（两种选择）

选项 1：使用免费预配密钥

我们提供了一个免费的 OpenRouter 密钥，让您可以立即体验 Caiioo。它支持访问精选的免费模型（有使用额度限制）——非常适合尝鲜体验。

如需持续使用：只需打开 Caiioo 并开始对话即可，无需任何设置。Pro 订阅用户每月可额外获得 $5/月的 OpenRouter 额度奖励，并在已有余额的基础上自动充值到此密钥中。

当您使用此自带密钥时，“设置”中的 OpenRouter 密钥字段不会显示为空，而是会明确提示——您将看到一条说明，指出您正在使用 Caiioo 的账户密钥以及您的剩余余额。您的密钥存储在本地设备上；开启 Private Sync 后，系统自带的密钥和您自己的 OpenRouter 密钥都会包含在加密备份中，同步到您的其他设备。

消耗额度的工具——包括图像、视频和音乐生成、高级 OCR 以及 Perplexity AI 搜索——不仅需要密钥，还需要 OpenRouter 额度。在免费预配密钥下，这些工具会提示“额度不足（no credits）”。您可以通过两种方式解决：在 Settings > AI Setup > AI Provider 中输入您自己的 OpenRouter API 密钥 (BYOK)，或者升级您的 Caiioo 方案——付费方案每月会为该预配密钥自动充值额度，从而直接使用这些工具。

选项 2：自带密钥 (BYOK)

想要不受免费层限制的完整访问权限？添加您自己的密钥即可。

OpenRouter（推荐）：

  1. 在 openrouter.ai 注册并创建 API 密钥
  2. 前往 Settings → AI Setup → AI Provider
  3. 选择 OpenRouter 并粘贴您的密钥——或者点击 Sign in with OpenRouter 直接连接您的账户，无需手动复制
  4. 大功告成——密钥仅保存在您的设备上，绝不会上传至 Caiioo 的服务器

Google AI（直连 Gemini）：

  1. 前往 Settings → AI Setup → AI Provider 并选择 Google AI
  2. 按照“获取免费密钥”的引导步骤操作（Google AI Studio 免费发放密钥，无需信用卡）
  3. 粘贴密钥——它将保留在您的设备上，所有请求直接发送至 Google

Anthropic（直连 Claude）：

  1. 前往 Settings → AI Setup → AI Provider 并选择 Anthropic
  2. 点击 Anthropic credentials 旁边的 Manage
  3. 点击 Create a key from your Claude account
  4. 在浏览器中授权访问，将授权码粘贴回 Caiioo，然后点击 Connect

您也可以点击 Add API key 并粘贴在 Anthropic Console 中创建的密钥。

Poe：

  1. 前往 Settings → AI Setup → AI Provider 并选择 Poe
  2. 在 poe.com/api/keys 创建密钥——密钥输入框下方的提示也包含该链接
  3. 将密钥粘贴至 Poe API Key

您的积分余额将显示在密钥下方。对话费用会同时以 Poe 积分和美元显示。

Ollama、vLLM、Unsloth 或 MLX（本地及网络服务器）：

  1. 启动本地模型服务器（Ollama 运行于 http://localhost:11434，vLLM 或 Unsloth 运行于 http://localhost:8000，或 MLX 运行于 http://localhost:8080）
  2. 前往 Settings > AI Setup > AI Provider
  3. 选择 Ollama、vLLM、Unsloth 或 MLX，确认服务器 URL（若使用局域网/远程服务器，可根据需要填写可选的 API 密钥/token），并选择主机提供的任意模型

当您选择本地对话模型时，如果 AI 工具需要将您的数据发送到远程 AI 服务商，系统会预先提示您进行确认。请参阅 Privacy & Data → Tools That Use Another AI Provider。

显示 Default Model 和 Max Steps 的模型配置

统一的 Caiioo Router 与 Effort（思考力度）控制

无需在各个独立的路由模式间艰难抉择或猜测哪个模型适合某项任务，只需在输入框的模型选择器中（或在设置 > AI 设置 > 模型配置中）启用 Caiioo Router 和 Effort：

  • Caiioo Router： 在模型选择器顶部选择 Caiioo Router，即可展开两个实时滑块：
    • 成本 ↔ 智能——滑向最低成本以进行快速、经济的日常对话；滑向平衡以获得最佳性价比；滑向最高智能以处理前沿推理。
    • 抗幻觉——在准确性至关重要时，提高事实依据和引用规范的权重。
    • 移动任意滑块时，下方的模型列表都会实时筛选并重新排序，以便您查看符合偏好的模型。
  • Effort 控制： 当所选模型（或 Caiioo Router）支持推理力度时，模型选择器中会直接显示 Effort 控制项。可选择 自动（或根据模型支持情况选择 关闭、低、中、高、最高）。Caiioo Router 会按照该对话所选的推理力度对模型进行排序和挑选，而非预设固定值。

快速任务模型

这是一个独立且成本更低的模型，Caiioo 会在后台自动调用它来生成话题标题、意图分类、决定调用哪个工具以及处理其他简短辅助查询——您无需直接向它提问。在「设置 → AI 设置 → 模型配置」中进行配置（一个轻量的 OpenRouter 免费模型或本地 Ollama 模型足矣）。如果未设置，系统将回退使用您的默认模型。

工具自带认证 (BYOA) — Pro

BYOA 与 BYOK 不同。它不用于大语言模型 — 而是用于工具连接（Google Workspace、Microsoft 365、GitHub 等）。在 Pro 方案中，当您的组织未将 Caiioo 的默认客户端 ID 列入白名单时，设置 → 连接器 → 添加 → 您自己的 OAuth 应用 允许您接入自己的 OAuth 客户端：

  • 使用您自己的 Google OAuth 应用 — 引导创建 Google Cloud 项目并粘贴客户端 ID 和密钥
  • 使用您自己的 Microsoft Azure 应用 — 适用于 Azure 注册应用的相同流程
  • 添加自定义 OAuth 提供商 — 适用于支持该协议的任何提供商的通用 OAuth 2.0 流程

向导会将凭据保存在您的设备上。它们绝不会离开设备。

每个提供商保留多个账户或密钥

每个提供商都可以保存多个凭据 — 例如工作密钥与个人密钥并存，或者登录账户与 API 密钥并存 — 一次仅使用其中一个。无需再覆盖密钥并在之后重新粘贴。

在设置 > 连接器中管理它们：每个提供商都是一行 AI 模型 类型，点击展开即可列出其账户和密钥。或者在设置 > AI 设置 > AI 提供商中点击提供商旁边的管理。您可以为每个凭据命名（例如“工作”），当前激活的凭据带有使用中徽标，点击使用即可一键切换。从 Caiioo 中移除凭据不会在提供商端撤销任何权限 — 您在提供商处的账户保持原样，日后可随时重新添加。

API 密钥安全

您的 API 密钥存储在您的本地设备上。开启私密同步后，您的密钥和已连接的提供商账户在进入同步备份之前会在设备上进行加密，然后仅在您的其他设备上解密。Caiioo 服务器绝不会接收到可读的凭据。当您发出请求时，运行对话的设备会将自身的活动凭据直接发送给 AI 提供商。请参阅隐私与数据了解完整详情。

性能取决于您选择的模型

Caiioo 负责协调编排——工具、上下文、多步骤工作流。但 AI 回答的质量最终取决于您选择的模型。

对于复杂任务（研究、分析、长文档）：建议使用前沿模型——Claude Sonnet、GPT 系列或 Gemini Pro——均可通过您的 OpenRouter 密钥访问。它们在处理多步骤推理和工具调用方面表现最佳。

对于快速问答（提问、摘要、简单编辑）：快速模型——Claude Haiku、较小规模的 GPT 或 Gemini Flash 变体——价格更低，速度更快。非常适合日常任务。

对于探索尝鲜：OpenRouter 让您仅用一个 API 密钥即可体验 500+ 款模型。无需绑定单一供应商，即可找到最适合您工作流的选择。

模型选择器会展示实际提供各模型服务的供应商的能力详情，并在已有评测数据时显示基准测试勋章。新发布或尚未评测的模型依然可见；只是暂时未获得勋章。总费用采用服务提供商公布的费率；如果 Caiioo 无法确定费率，则会直接省去费用显示，而不会采用估算值。

两枚勋章，两个不同的问题。 模型可在一项或两项指标中获得金、银或铜牌：

  • Best for Caiioo 仅根据能力进行排名。价格不计入其中，因此便宜快速的模型无法领跑被评为最佳的榜单。
  • Value for Caiioo 则是衡量性价比的指标——即在相应成本下所能获得的最佳品质。

Caiioo Router 直接使用这些相同的基准测试数据：向 Balanced 或 Lowest cost 滑动会在考量质量的同时权衡价格，而向 Highest intelligence 滑动则会优先考虑模型能力。您在选择器中看到的指标，就是应用程序实际进行选取的依据。

查看勋章背后的测试数据。 Model Intelligence（Caiioo Benchmarks，Pro）对比了质量、吞吐量、首字时间 (time-to-first-token)、工具准确率以及定价，并详细阐述了评估方法——包括各项数据的来源以及超值评分所考量的因素。每类任务的排名一经发布，便会由应用程序以及 caiioo.ai 上的排行榜同步读取，因此路由选择的模型与排行榜上展示的结果完全一致。如果您希望了解哪款模型在编程、研究或写作（而非仅综合表现）中处于领先地位，排行榜还额外提供了 Best by Use Case 细分视图。

关于 Creativity 滑块的说明：最新的模型（如 Claude Sonnet 5 及后续版本）会自行管理创造力，不接受 temperature 设置。当您选中这类模型时，Model Configuration 中的 Creativity 滑块将被禁用并附带简短说明——这是正常现象，并非软件错误。

对于离线 / 完全私密的工作：Ollama 可以在您的本地机器上运行开源模型。虽然速度慢于云端前沿模型，但任何数据都不会离开您的硬件设备。

Caiioo 的工具、上下文层和编排能力可以充分放大您所选模型的潜能。在匹配了正确的上下文与工具后，优秀的模型便能发挥出卓越的表现。

另请参阅

This guide is maintained by the Caiioo team using Slate, our built-in editor.