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

AI 提供商和 API 密钥

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

支持的提供商

目前通常提供两种提供商：

  • OpenRouter（默认）—— 单个密钥即可解锁 500 多种模型，包括 Anthropic Claude、Google Gemini、OpenAI GPT、Mistral、Groq、Llama 等。这是大多数用户的推荐路径 —— Caiioo 的工具依赖 OpenRouter 的模型注册表，且您只需管理一个密钥。
  • Ollama —— 在您的机器上本地运行开源模型。完全私密，无需互联网，免费。适用于离线工作或当您想要绝对控制推理过程时。

直接连接 Anthropic、Google Gemini、OpenAI、Poe 和 MLX 的功能已在计划中，但尚未正式发布。目前，请通过您的 OpenRouter 密钥使用这些模型 —— 这正是 OpenRouter 的用途。

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

开始使用（两种选项）

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

我们提供了一个免费的 OpenRouter 密钥，让您可以立即尝试 Caiioo。它可以访问选定的免费模型，并设有使用限制——非常适合进行测试。

继续使用的方法：只需打开 Caiioo 并开始聊天。无需任何设置。Pro 订阅者每月可获得额外的 $5 OpenRouter 额度奖励，该额度会自动应用到此密钥中，并叠加在现有余额之上。

消耗额度的工具——图像、视频和音乐生成、高级 OCR 以及 Perplexity AI 搜索——需要 OpenRouter 额度，而不仅仅是密钥。在免费提供的密钥上，这些工具会报告“无额度”。您有两种解决方法：在“设置 > AI 提供商”中输入您自己的 OpenRouter API 密钥 (BYOK)，或者升级您的 Caiioo 方案——付费方案每月会为这个提供的密钥充值额度，使这些工具可以正常使用。

选项 2：自带密钥 (BYOK)

想要获得不受免费层级限制的全功能访问权限？请添加您自己的密钥。

OpenRouter（推荐）：

  1. 在 openrouter.ai 注册并创建一个 API 密钥
  2. 前往 设置 → AI 提供商
  3. 选择 OpenRouter 并粘贴您的密钥
  4. 大功告成 —— 密钥保存在您的设备上，永远不会到达 Caiioo 的服务器

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 允许您插入自己的 OAuth 客户端：

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

向导会将凭据直接写入凭据库。它们绝不会离开您的设备。

API 密钥安全

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

性能取决于您的模型

Caiioo 负责编排 —— 工具、上下文、多步工作流。但 AI 响应的质量取决于您选择的模型。

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

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

对于实验：OpenRouter 让您只需一个 API 密钥即可尝试 500 多种模型。找到最适合您工作流的模型，而无需绑定到单一提供商。

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

Caiioo 的工具、上下文层和编排功能会放大您所选模型的能力。当一个优秀的模型拥有正确的上下文和工具时，它会变得卓越。

另请参阅

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