Coze

一文搞定 Coze 接入 OpenAI Hub API

这篇教程帮你在 Coze 中快速接入 OpenAI Hub 的大模型接口，用 Coze 的插件系统来调用 https://api.openai-hub.com/v1，实现和 GPT、Claude 等模型的无缝连接。

---

1. 注册 & 创建智能体

登录 Coze 官网 ，注册一个账号。进入后台后：

• 点击左侧的 “创建 Bot / 智能体”。
• 填个名字，比如 “AI 内容助手”。
• 描述随便写点，比如 “帮我生成文案和回答问题”。
• 模型可以先选任意一个占位，后面我们会替换成 OpenAI Hub 接口。

搞定后点保存，暂时不用发布。

---

2. 获取 OpenAI Hub API Key

到 OpenAI Hub 控制台 获取密钥：

• 注册登录控制台。
• 在左侧栏找到 API 密钥管理。
• 创建一个新的 Key，比如 sk-your-api-key。

这个 Key 是唯一凭证，不建议贴到任何群聊或公开 Git 仓库里。

---

3. 在 Coze 创建 API 插件

点开左侧的 “插件（Plugin）”，创建一个新的自定义插件。

配置如下：

• 插件名称：OpenAI Hub 中转调用（随便起）

• 类型：HTTP API

• 请求方法：POST

• 接口地址(Base URL)：https://api.openai-hub.com/v1/chat/completions

• 认证方式：在 Header 添加：

  {
    "Authorization": "Bearer sk-your-api-key",
    "Content-Type": "application/json"
  }
  

• 输入参数定义：

  [
    {
      "name": "prompt",
      "type": "string",
      "required": true,
      "description": "用户输入内容"
    }
  ]
  

• 请求体映射（Body）：

  {
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "{{input.prompt}}" }
    ]
  }
  

⚠️ 注意坑点： Coze 填写 URL 时不要加多余的 /，否则有时会提示 “Invalid request path”。同时，Header 里的 Bearer 后面需要有一个空格。

---

4. 调试插件是否生效

配置好后在插件页点 “测试”。输入：

prompt = 给我写一句鼓励自己学习的话

正常的话，会返回模型生成的结果。如果显示超时，说明国内直连被拦，你得确认地址是否为：

https://api.openai-hub.com/v1/chat/completions

这是国内可以直连的中转地址。

---

5. 把插件挂到智能体上

返回 Bot 编辑页，点击 “添加工具 / 插件”，把刚才创建的插件加进去。

在对话流程中设置触发逻辑，比如：让 Bot 听到 “问AI” 关键词时调用刚才的插件。

搞定后可以在右下角点 “调试”，看看 Bot 的回复是否经过 OpenAI Hub 的接口。

---

6. 进阶：支持多模型切换

如果你想让一个插件支持多模型，比如 GPT-4、Claude 3、Gemini 1.5，可以这样改 Body：

{
  "model": "{{input.model|default('gpt-4o-mini')}}",
  "messages": [
    { "role": "user", "content": "{{input.prompt}}" }
  ]
}

再在输入参数列表里加一个 model，类型是字符串。这样调用插件时，你可以动态指定模型名称。

---

7. 在 Workflow 里调用（可选）

如果你在 Coze 用 Workflow 做多步处理，比如“提问 → 改写 → 输出结果”，可以在某个节点加上这个自定义插件来实现问答或内容生成。和乐高搭积木一个思路。

---

下一步可以试试

你可以在 Coze 的 Knowledge 模块加个简单 FAQ 知识库，然后再让插件负责生成延伸内容。这样既能查知识又能创作输出，Bot 就真正“活”起来了。