Coze 不同版本和部署形态的菜单名称可能略有差异。本文以“添加 OpenAI 兼容模型服务”的通用流程为准:核心是填写 API Key、Base URL 和模型 ID。
接入参数
配置步骤
2
进入模型服务配置
在 Coze / Coze Studio 中进入模型、模型服务或资源配置页面。添加新的模型服务时,选择
OpenAI Compatible、OpenAI API Compatible 或类似的 OpenAI 兼容接入方式。3
填写服务地址和鉴权信息
按下面方式填写:如果页面要求填写模型名称或模型 ID,请填写你要使用的模型,例如:
4
保存并测试连通性
保存模型服务后,使用页面内的测试功能发送一条短消息。如果 Coze 返回模型回复,说明服务已经配置成功。
5
在 Bot 或 Agent 中选择模型
回到 Bot、Agent 或工作流编排页面,将默认模型切换为刚刚添加的模型服务。如果同一个 Bot 中有多个节点调用模型,请逐个检查节点使用的模型配置。
推荐配置
日常 Bot
使用
gpt-4o 或其他通用对话模型。复杂 Agent
使用
claude-sonnet-4-20250514 等更适合推理和长上下文的模型。调试建议
模型测试成功,但 Bot 不生效
检查 Bot 当前发布版本是否已经选择新模型。有些 Coze 环境需要重新发布或重新运行调试会话后才会使用新配置。返回 401 或鉴权失败
重新复制 API Key,确认没有多余空格。Coze 配置页通常只填写 Key 本身,不需要填写Bearer 前缀。
返回 404 或路径不存在
检查 Base URL 是否为:https://gogogotoken.ai/v1/chat/completions。
