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

# 百度千帆

> 百度千帆 ERNIE 模型配置（文本对话 + 图像理解）

百度千帆提供 ERNIE 系列模型，支持文本对话与图像理解。

<Tip>
  通过 Web 控制台的「模型管理」页面可一站式配置以下全部能力，无需手动改配置文件。
</Tip>

## 文本对话

```json theme={null}
{
  "model": "ernie-5.1",
  "qianfan_api_key": "YOUR_API_KEY",
  "qianfan_api_base": "https://qianfan.baidubce.com/v2"
}
```

| 参数                 | 说明                                                                                            |
| ------------------ | --------------------------------------------------------------------------------------------- |
| `model`            | 默认推荐使用 `ernie-5.1`；也可使用 `ernie-5.0`、`ernie-x1.1`、`ernie-4.5-turbo-128k`、`ernie-4.5-turbo-32k` |
| `qianfan_api_key`  | 千帆 API Key，格式通常以 `bce-v3/` 开头                                                                 |
| `qianfan_api_base` | 可选，默认为 `https://qianfan.baidubce.com/v2`                                                      |

### 模型选择

| 模型                     | 适用场景                      |
| ---------------------- | ------------------------- |
| `ernie-5.1`            | 默认推荐，文心新一代旗舰模型，综合能力最强     |
| `ernie-5.0`            | 上一代旗舰模型，综合能力优异            |
| `ernie-x1.1`           | 深度思考推理模型，幻觉更低、指令遵循与工具调用更强 |
| `ernie-4.5-turbo-128k` | 长上下文和通用对话                 |
| `ernie-4.5-turbo-32k`  | 通用对话，成本和上下文更均衡            |

## 图像理解

配置 `qianfan_api_key` 后，Agent 的 Vision 工具可以自动使用千帆视觉模型：

* 当主模型本身是多模态时（如 `ernie-5.1`、`ernie-5.0`、`ernie-x1.1`、`ernie-4.5-turbo-vl`），直接由主模型识别图像，无需额外配置
* 当主模型是纯文本时（如 `ernie-4.5-turbo-128k`），Vision 工具会自动 fallback 到 `ernie-4.5-turbo-vl`

如需手动指定 Vision 模型，可在配置文件中显式配置：

```json theme={null}
{
  "tools": {
    "vision": {
      "model": "ernie-4.5-turbo-vl"
    }
  }
}
```

<Tip>
  新配置推荐使用 `qianfan_api_key`。旧的 `wenxin`、`wenxin-4`、`baidu_wenxin_api_key`、`baidu_wenxin_secret_key` 配置仍保持兼容。
</Tip>