> ## Documentation Index
> Fetch the complete documentation index at: https://otterflow.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型服务

> 启用内置模型，或配置自定义模型服务。

「模型服务」页决定了 Otterflow 背后由哪些大模型驱动。你既可以直接启用官方内置的模型，也可以接入自己的私有模型或第三方接口。两者可以并存，随时在聊天界面切换。对希望自带 API、控制成本或使用特定模型的研究者来说，这一页尤其重要 🦦。

## 内置模型

「内置模型列表」用于管理 Otterflow 随附的模型。正如页面说明所述：「管理内置模型，开启后可在聊天界面进行切换」。

使用方式很直接：

1. 在「内置模型」区域找到你想使用的模型。
2. 打开它的开关。
3. 回到聊天界面，在模型选择器中即可看到并切换到刚开启的模型。

内置模型的用量会计入你的账户额度，具体余量与消耗趋势可在 [账号与计费](/zh/settings/account-and-billing) 中查看。

## 自定义模型

如果你有自己的模型服务，或想接入某个第三方接口，可以点击「添加自定义模型」。表单说明写道：「配置您的私有模型或第三方接口；不确定时请选择 OpenAI Chat Completions」。

添加一个自定义模型需要填写以下字段：

| 字段                | 说明            | 示例                           |
| ----------------- | ------------- | ---------------------------- |
| 模型 ID             | 服务方定义的模型标识    | `gpt-4.1` / `deepseek-chat`  |
| API 密钥 (Key)      | 用于鉴权的密钥       | 服务方分配的 Key                   |
| API 端点 (Base URL) | 接口的基础地址       | 服务方提供的 Base URL              |
| 上下文窗口 (tokens)    | 模型可处理的最大上下文长度 | `128000`                     |
| API 协议            | 请求所遵循的接口协议    | Chat / Responses / Anthropic |

填写完成后保存，这个模型就会出现在聊天界面的模型选择器里，与内置模型并列可选。

> 📷 **〔占位图：自定义模型表单〕** —— 展示添加自定义模型的表单（模型 ID / API 密钥 / Base URL / 协议）。

## 协议怎么选

「API 协议」决定了 Otterflow 用哪种接口规范去调用你填入的端点。选错协议会导致请求失败，因此这一项需要与你的服务方对齐。三种协议如下：

| 协议            | 适用场景                                                 |
| ------------- | ---------------------------------------------------- |
| **Chat**      | 默认选项；适合 OpenAI-compatible、OneAPI 和大多数中转站。**不确定就选它。** |
| **Responses** | 仅限完整支持官方 `/responses` API 的端点。                       |
| **Anthropic** | 适合 Anthropic Claude `/v1/messages` 兼容端点。             |

选择思路很简单：

* 你的服务是常见的 OpenAI 兼容接口、OneAPI 网关或某个中转站？选 **Chat**。这是覆盖面最广的选项，拿不准时它就是安全答案。
* 你确认端点完整实现了官方的 `/responses` API？才选 **Responses**。
* 你接入的是 Anthropic Claude 的 `/v1/messages` 兼容端点？选 **Anthropic**。

## 提示

* 页面底部提示：「某些模型可能需要配置对应的 API 密钥才能正常工作」。如果添加后模型无法响应，请先检查 API 密钥是否正确、是否与该模型匹配。
* Base URL、协议、模型 ID 三者需要与服务方文档保持一致，任何一处不符都可能导致调用失败。
* 上下文窗口应按模型的真实上限填写，过大可能在长文本请求时触发服务方报错。
* 不确定协议时始终优先选 **Chat**，它兼容绝大多数中转与聚合服务。

## 另见

* [与 AI 对话写作](/zh/core-features/ai-writing) —— 在聊天界面切换并使用已启用的模型。
* [账号与计费](/zh/settings/account-and-billing) —— 查看内置模型的额度余量与消耗趋势。