Assistela Assistela 文档
Assistela 设置

自己的 LLM 提供商

使用 API 密钥连接自己的 LLM 提供商账户,或使用 ChatGPT 订阅登录。

开始之前

要通过 API 连接,你需要所选提供商的账户及其 API 密钥。ChatGPT 订阅和 OpenAI API 是两项独立服务:仅有 ChatGPT Plus 不会自动生成 OpenAI API 密钥或 API 额度。

安全存储

Assistela 询问密码和访问密钥的存储位置时,正常使用请选择 使用 Mac Keychain。Assistela 数据更容易备份,但其中含有密钥时也会变得更为敏感。

OpenAI、Anthropic 或其他已列出的提供商

1

添加 AI 账户

打开 Assistela → 设置 → AI 账户,点击左下角的 +,然后选择提供商。

2

检查 API 服务器

对于已列出的提供商,账户 标签页中的 API 服务器地址 已预先填写。除非提供商明确给出其他地址,否则不要修改。

3

粘贴 API 密钥

访问密钥 中,按提供商控制面板显示的原样粘贴 API 密钥,不要添加空格或引号。

4

保存并检查

点击 保存并检查账户,等待账户就绪或连接正常的消息。

5

选择模型

打开 模型 标签页。保留预设模型,或刷新模型列表并选择其他模型。只有在提供商未通过列表返回模型时,才手动输入模型名称。

6

设为默认账户

在“账户”标签页点击 设为默认,然后在“聊天”中发送测试消息。

自定义 OpenAI 兼容或 Anthropic 兼容 API

+ 菜单选择 自定义 OpenAI 兼容自定义 Anthropic 兼容。自定义账户不会预填服务器地址。

  • API 服务器地址 中输入提供商文档中的完整 URL。OpenAI 兼容 API 通常含有 /v1 等路径,但应以具体提供商的文档为准。
  • 确认正确的连接格式:OpenAI API 格式Anthropic Messages API 格式
  • 粘贴 API 密钥,然后点击 保存并检查账户
  • 模型 标签页加载模型列表。如果 API 不提供列表,请选择自定义模型并输入准确的模型 ID。

无需 API 密钥的 ChatGPT 订阅

1

选择 ChatGPT 订阅

设置 → AI 账户 中点击 +,然后选择 ChatGPT 订阅

2

开始连接

点击 连接 ChatGPT。Assistela 会显示一次性代码。

3

打开 OpenAI

使用 打开 OpenAI 页面复制代码。在打开的页面中登录正确的 ChatGPT 账户并输入代码。

4

等待确认

返回 Assistela 并保持窗口打开。应用会自动检查连接数分钟。如果出现确认已输入代码的按钮,请点击该按钮。

5

设为默认账户

连接成功后,点击 设为默认,然后测试“聊天”。

常见问题

  • 密钥无效:重新创建或复制 API 密钥,然后再次保存账户。
  • API 服务器地址无效:根据提供商文档检查 https://、API 路径和末尾的 /v1
  • 找不到模型:刷新模型列表或输入准确的模型 ID。
  • 账户正常但聊天没有使用它:将账户设为默认,并确认账户已启用。

无需复杂调校即可选择模型

主账户应先使用提供商注明支持 tool calling 的模型。如果聊天能回复,却无法使用日历、电子邮件或其他操作,请先验证工具支持,再更改高级令牌设置。

  • 将功能全面的通用模型设为聊天和复杂工作的默认模型。
  • 更便宜、更快的模型适合频繁执行简单的自动检查。
  • 更换模型后,请使用“保存并检查账户”,然后测试一项安全的只读操作。

如需在多个模型之间分配工作,请参阅 模型路由