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

AI 提供商和 API 密钥

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

支持的提供商

目前通常提供五个提供商：

  • OpenRouter（默认）——单个密钥即可解锁 500 多个模型，包括 Anthropic Claude、Google Gemini、OpenAI GPT、Mistral、Groq、Llama 等。这是大多数用户的推荐路径——Caiioo 的工具需要 OpenRouter 的模型注册表，并且您只需管理一个密钥。
  • Google AI ——使用您自己的 Google AI 密钥直接连接到 Gemini API。Google 提供真正的免费配额，因此这是运行前沿模型的真正免信用卡方式——具有原生思考能力和高达 200 万的上下文。设置会引导您获取免费密钥。
  • xAI (Grok) ——通过 api.x.ai 直接访问 Grok 模型。使用 xAI 控制台 API 密钥连接，或者只需使用您的 Grok 账户登录（SuperGrok 或 X Premium+ 订阅）——在浏览器中批准访问即可连接，无需复制密钥。注意：xAI 在其端按账户和订阅层级启用 API 访问权限；如果连接后聊天因权限错误而失败，请改用 xAI API 密钥。
  • CometAPI ——通过一个按需付费的 CometAPI 密钥访问 500 多个模型（GPT、Claude、Gemini、DeepSeek 等）。模型选择器为其目录显示基准层级的奖牌，且总 CometAPI 使用量可在设置中追踪。
  • Ollama ——在您的本地机器上运行开源模型。完全私密，无需联网，免费。适用于离线工作或当您希望完全控制推理时。（Ollama Cloud 也支持可选的 API 密钥。）

对其他提供商（Anthropic、OpenAI、Poe、MLX 等）的直接连接目前正在测试中，尚未全面推出。目前，请通过您的 OpenRouter 密钥使用这些模型——这就是 OpenRouter 的用途。

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

开始使用（两种选项）

选项 1：使用免费提供的密钥

我们提供了一个免费的 OpenRouter 密钥，让你能够立即体验 Caiioo。它可用于访问部分受使用限制的免费模型——非常适合进行测试。

若要继续使用：只需打开 Caiioo 并开始聊天。无需进行任何设置。Pro 订阅用户除了已有的余额之外，还可在此密钥上自动获得额外的 $5/月 OpenRouter 额度奖励。

当你使用自带的密钥时，“设置”中的 OpenRouter 密钥字段会显示相应说明，而不会呈现空白状态——你会看到一条提示，表明你正在使用 Caiioo 的账户密钥以及你的剩余余额。自带的密钥会保留在你设置它的设备上；你自己的 OpenRouter 密钥同样按设备存储，并且只有在开启私密同步（Private Sync）后才会显示在其他设备上。

消耗额度的工具——图像、视频和音乐生成、高级 OCR 以及 Perplexity AI 搜索，需要 OpenRouter 额度，而不仅仅是一个密钥。在使用免费提供的密钥时，这些工具会提示“无额度”。你有两种解决方案：在“设置”>“AI 提供商”中输入你自己的 OpenRouter API 密钥（BYOK），或者升级你的 Caiioo plan——付费计划会在每个月为这个提供的密钥充入额度，从而使这些工具可以直接使用。

选项 2：自带密钥（BYOK）

想要在没有免费层限制的情况下获得完全访问权限？添加你自己的密钥。

OpenRouter（推荐）：

  1. 在 openrouter.ai 注册并创建一个 API 密钥
  2. 转到“设置” → “AI 提供商”
  3. 选择 OpenRouter 并粘贴你的密钥——或者点击 Sign in with OpenRouter 来连接你的账户，无需复制任何内容
  4. 就是这样——密钥将保留在你的设备上，绝不会发送到 Caiioo 的服务器

Google AI（Gemini 直连）：

  1. 转到“设置” → “AI 提供商”并选择 Google AI
  2. 按照引导式的“获取免费密钥”步骤操作（Google AI Studio 免费发放密钥，无需信用卡）
  3. 粘贴密钥——密钥会保存在你的设备上，请求将直接发送给 Google

Ollama（本地）：

  1. 从 ollama.com 安装 Ollama 并拉取一个模型（ollama pull llama3.2）
  2. 转到“设置” → “AI 提供商”
  3. 选择 Ollama 并确认服务器 URL（默认 http://localhost:11434）
  4. 选择你在本地安装的任意模型

当你选择本地聊天模型时，那些会将你的数据发送到远程 AI 提供商的 AI 驱动型工具会首先征求你的批准。请参阅 隐私与数据 → 远程 AI 提供商。

显示默认模型和最大步数的模型配置

快速任务模型

这是一个独立且更便宜的模型，Caiioo 会在后台自动将其用于诸如生成对话标题、分类意图、选择调用哪个工具以及其他简短的辅助查询——你永远不会直接对其进行提示。在“设置” → “模型配置”中进行配置（一个小的 OpenRouter 免费模型或本地 Ollama 模型就足够了）。如果未设置，系统将回退到你的默认模型。

工具自带认证 (BYOA) — Pro 版

BYOA 与 BYOK 不同。它不是针对大语言模型 (LLM) 的，而是针对工具连接（Google Workspace、Microsoft 365、GitHub 等）。在 Pro 版中，“设置” → “账户” → “账户授权与权限”允许您在组织不愿将 Caiioo 的默认客户端 ID 加入白名单时接入您自己的 OAuth 客户端：

  • 使用您自己的 Google OAuth 应用 — 按照步骤创建一个 Google Cloud 项目并粘贴客户端 ID 和密钥
  • 使用您自己的 Microsoft Azure App — 针对 Azure 注册应用的相同流程
  • 添加自定义 OAuth 提供商 — 针对支持该功能的任何提供商的通用 OAuth 2.0 流程

向导会将凭据直接写入凭据保险库 (Credentials Vault)。它们绝不会离开您的设备。

API 密钥安全

您的 API 密钥存储在您的设备本地。它们永远不会发送到 Caiioo 服务器。当您发起请求时，您的密钥会直接发送给 AI 提供商。完整说明请参阅 隐私与数据。

性能取决于您选择的模型

Caiioo 负责处理编排工作——包括工具、上下文以及多步骤工作流。但 AI 响应的质量最终取决于您所选择的模型。

对于复杂任务（研究、分析、长文档）：请使用前沿模型 —— Claude Sonnet、GPT 级别或 Gemini Pro —— 这些都可以通过您的 OpenRouter 密钥访问。它们最擅长处理多步骤推理和工具调用。

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

对于实验探索：OpenRouter 允许您使用一个 API 密钥尝试 500 多个模型。无需绑定单一提供商，即可找到最适合您工作流的模型。

关于“创造力”滑块的说明：最新的模型（例如 Claude Sonnet 5 及更高版本）会自行管理其创造力，并且不接受温度（temperature）设置。当您选择此类模型时，模型配置中的“创造力”滑块将被禁用并附带简短说明 —— 这是正常现象，并非错误。

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

Caiioo 的工具、上下文层和编排功能可以放大您选择的任何模型的效能。当好模型拥有正确的上下文和工具时，它就会变得更加出色。

另请参阅

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