> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeus.agentspro.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 模型配置

> Zeus 模型配置与管理

## 概述

Zeus 支持灵活的模型配置，用户可以使用自有 API Key 接入任意 OpenAI 兼容模型，也可以使用 Zeus 预置模型。

## 配置来源

```mermaid theme={null}
graph LR
    user_custom["用户自定义模型<br/>自有 API Key + Base URL"]
    zeus_preset["Zeus 预置模型<br/>zeus-1.5 / zeus-1.5-pro / zeus-1.5-lite"]
    default["默认回退<br/>Zeus 系统模型"]

    user_custom -->|"优先级 1"| LLM["ChatOpenAI 实例"]
    zeus_preset -->|"优先级 2"| LLM
    default -->|"优先级 3"| LLM
```

模型配置按以下优先级选择：用户自定义配置 > 请求参数 > 系统默认配置。

## Zeus 预置模型

Zeus 内置三个预置模型层级，每个对应特定的供应商和模型：

| 预置            | 实际模型                     | 供应商      | 最大 Tokens | 层级 |
| ------------- | ------------------------ | -------- | --------- | -- |
| zeus-1.5      | kimi-k2.5                | Moonshot | 262,144   | 标准 |
| zeus-1.5-pro  | claude-opus-4-5-20251101 | UnifyLLM | 200,000   | 专业 |
| zeus-1.5-lite | gemini-2.5-pro           | UnifyLLM | 1,048,576 | 轻量 |

用户在界面中选择预置层级，系统自动路由到对应的供应商和模型。使用预置模型时无需配置 API Key。

## LLMManager

LLM 模型管理器负责创建模型实例。`_init_model()` 接收前端传递的 LLM 配置（包含 Base URL、API Key、模型名、温度等参数），创建 `ChatOpenAI` 实例。

首先检查是否存在用户自定义模型配置（包含自有 API Key 和 Base URL），如果没有则检查 Zeus 预置模型选择，路由到对应的供应商。最终回退到系统默认配置。支持任何 OpenAI 兼容 API（OpenAI、Anthropic via proxy、本地模型等）。

## Model Profiles

系统内置 200+ 模型的上下文窗口配置，用于 `SummarizationMiddleware` 的触发阈值计算：

| 模型                | max\_input\_tokens | 摘要触发 (85%) |
| ----------------- | ------------------ | ---------- |
| gpt-4o            | 128,000            | 108,800    |
| claude-3.5-sonnet | 200,000            | 170,000    |
| gpt-4-turbo       | 128,000            | 108,800    |
| 默认                | 64,000             | 54,400     |

当模型不在预定义列表中时，使用默认配置。