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

# 自定义模型 / BYOK

> 通过 Base URL、API Key 和模型名添加自定义模型供应商。

BYOK 指使用自己的 API Key，也就是模型供应商提供的访问密钥。你可以选择预设供应商，或手动添加兼容的模型服务，然后在 MiniMax Code 的模型菜单中选择并使用。

![自定义模型新增或编辑弹窗](https://mintcdn.com/agent-cn/Ju0RTrTtHAbDym7K/images/code/byok-custom-model.png?fit=max\&auto=format\&n=Ju0RTrTtHAbDym7K\&q=85\&s=a57f6e30d34a1c505fdb11e6f083062e)

## 添加供应商

**1. 打开自定义模型**

打开 **设置 → 用量与模型**，在自定义模型中点击添加模型。

**2. 选择预设或其他**

搜索并选择预设提供商，填写自己的 API Key。预设会提供接口地址、API 格式和模型配置。如果列表中没有需要的服务，选择其他，填写提供商名称、接口地址、API Key 和 API 格式。

**3. 添加模型**

输入模型 ID，或点击自动获取，从供应商返回的模型列表中选择要添加的模型。模型 ID 需要与供应商文档一致。

**4. 保存并选择**

点击保存。回到消息输入框，从模型菜单中选择刚添加的模型；支持思考参数的模型还可以在参数菜单中调整。

接口地址是模型服务接收请求的网址；API 格式是服务使用的通信格式，按供应商提供的接入说明填写即可。

## 保存与连接测试

| 操作 | 作用 |
| - | - |
| 自动获取 | 读取供应商的模型列表，供你选择添加；不会保存配置。 |
| 连通检测 | 点击模型旁的检测按钮，使用当前填写的信息，检查对应模型能否响应。 |
| 保存 | 保存供应商和模型配置；不会自动测试，也不会切换当前任务的模型。 |

## 建议

建议先完成连接测试，再用于正式任务。测试通过说明本次请求成功，图片、视频等输入能力仍需按实际使用场景验证。

> [!WARNING]
>
> 自定义模型的可用性、上下文长度、多模态支持和费用由对应供应商决定。

如果你希望由 Agent 修改配置文件并验证模型响应，请使用 [Agent 的 BYOK 模型配置指南](https://agent.minimaxi.com/docs/code/account/byok-agent-setup.md)。