MaiToken
登录/注册

CozeStudio

适用场景：

适合已经在本地或服务器部署 Coze Studio，并需要使用 MaiToken 模型搭建智能体和工作流的用户。
本节适用于 Coze Studio 开源版。开始配置前，请先完成 Coze Studio 部署，并确认能够正常打开管理后台。

开始配置

  1. 打开模型管理： 在部署 Coze Studio 的设备上打开 http://localhost:8888/admin/#model-management 。如果部署在服务器上，请将 localhost 替换为实际管理地址。

  2. 新增模型： 单击“新增模型”或 Add Model。

  3. 选择协议： Protocol 选择 openai。

  4. 填写 Base URL： 输入 https://api.maitoken.com/v1 。模型管理页面要求填写 Base URL，通常不要添加 /chat/completions。

  5. 填写 API Key： 粘贴您自己的 MaiToken Key。

  6. 填写模型 ID： 在模型 ID 或 Model 中填写 <模型ID>。模型投入使用后，请勿随意修改 ID，否则现有 Agent 可能无法找到该模型。

  7. 配置模型能力： 根据模型的实际能力启用 Function Calling、Vision 和 Reasoning 等选项。如果不确定，可以先启用文本和工具调用能力。

  8. 测试并保存： 单击“测试”。测试通过后，保存并启用模型。

  9. 在 Agent 中选择模型： 新建一个测试 Agent，从模型选择器中选择刚刚添加的 MaiToken 模型，保存后进入调试页面。

字段 填写内容
Protocol openai
Base URL https://api.maitoken.com/v1
API Key <你的 MaiToken Key>
Model ID <模型ID>

配置完成后这样测试

  1. 测试普通对话： 在聊天框中输入“只回复 OK”。如果收到正常回复，说明 API Key、API 地址和模型 ID 基本正确。

  2. 测试工具调用： 输入“请调用一个简单工具；如果当前没有可用工具，则只回复 OK。”

  3. 测试 Agent： 让 Agent 执行一个简单的测试任务，并检查运行结果是否符合预期。请勿使用真实生产业务进行首次测试。

常见问题

问题 处理建议
管理后台无法打开 确认 Coze Studio 已经部署并启动；如果使用 Docker 部署，还需要检查端口映射。
模型测试返回 404 Base URL 应填写为 https://api.maitoken.com/v1 ，不要添加 /chat/completions。
Agent 找不到模型 确认模型已经启用，然后刷新 Agent 编辑页面中的模型选择器。