> ## 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 和模型名添加自定义模型供应商。

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

  <img src="https://mintcdn.com/agent-cn/Ju0RTrTtHAbDym7K/images/code/byok-custom-model.png?fit=max&auto=format&n=Ju0RTrTtHAbDym7K&q=85&s=a57f6e30d34a1c505fdb11e6f083062e" alt="自定义模型新增或编辑弹窗" className="code-screenshot" width="1162" height="1458" data-path="images/code/byok-custom-model.png" />

  ## 添加供应商

  <Steps>
    <Step title="打开自定义模型">
      打开 **设置 → 用量与模型**，在自定义模型中点击添加模型。
    </Step>

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

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

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

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

  ## 保存与连接测试

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

  ## 建议

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

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

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