Coze 接入第三方 API 快速教程：用自定义插件调用模型接口

Coze 可以通过自定义 HTTP API 插件调用外部接口。由于 NixAPI 提供 OpenAI 兼容的 chat/completions 接口，你可以在 Coze 里创建一个插件，把用户输入转发给 NixAPI 模型，再把结果返回给智能体。

这种方式适合想在 Coze Bot 中使用自定义模型、动态模型路由或统一 API Key 管理的场景。

---

准备工作

你需要准备：

1. 一个 Coze 账号
2. 一个 NixAPI API Key
3. 一个准备挂载插件的 Coze Bot

NixAPI API Key 可以在 NixAPI 控制台 创建。模型列表和价格可参考 NixAPI 模型价格页。

---

第一步：创建 Coze 智能体

登录 Coze，进入后台后创建一个 Bot。

可以先填写基础信息：

• 名称：例如 AI 内容助手
• 描述：例如 根据用户输入生成回答、摘要和文案
• 默认模型：先选任意可用模型作为占位

保存即可，暂时不需要发布。后面会通过插件调用 NixAPI。

---

第二步：创建自定义 HTTP API 插件

进入 Coze 的插件管理页面，创建一个自定义插件。插件类型选择 HTTP API。

基础配置建议如下：

配置项	填写内容
插件名称	NixAPI 模型调用
请求方法	POST
接口地址	https://nixapi.com/v1/chat/completions
认证方式	Header 中手动添加 Bearer Token

接口地址应填写完整路径：

https://nixapi.com/v1/chat/completions

这里不是只填 https://nixapi.com/v1，因为 Coze 插件需要调用具体 HTTP API。

---

第三步：配置请求 Header

在 Header 中添加：

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

把 nix-your-api-key 换成你的真实 Key。

注意 Bearer 后面必须有一个空格。Header 中不要把 Key 暴露给普通用户，也不要截图公开完整 Key。

---

第四步：定义输入参数

先做一个最小可用版本，只接收用户输入：

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

如果后续需要动态切换模型，可以再增加一个 model 参数。

---

第五步：配置请求体

最小请求体如下：

{
  "model": "claude-sonnet-4-20250514",
  "messages": [
    {
      "role": "user",
      "content": "{{input.prompt}}"
    }
  ]
}

可选模型示例：

• claude-sonnet-4-20250514
• gpt-5.4
• gemini-3-pro-preview
• deepseek-v4
• minimax-m3

模型 ID 请以 NixAPI 支持的模型列表页 为准。

---

第六步：调试插件

在插件调试页输入：

prompt = 给我写一句适合周一早会开场的话

如果返回模型生成的内容，说明插件已能成功调用 NixAPI。

如果 Coze 返回超时、401 或 404，按下面顺序检查：

1. URL 是否为 https://nixapi.com/v1/chat/completions
2. Header 是否包含 Authorization: Bearer nix-your-api-key
3. API Key 是否来自 NixAPI 控制台
4. 模型名是否存在

---

第七步：挂载到 Bot

回到 Bot 编辑页，添加工具或插件，选择刚才创建的 NixAPI 模型调用。

你可以设置触发逻辑，例如：

• 用户输入包含 问AI 时调用插件
• 工作流中的某个节点需要生成内容时调用插件
• 知识库检索后，把检索结果和用户问题一起发给插件

调试时建议在 Bot 中明确告诉模型何时调用该插件，避免插件被频繁误触发。

---

进阶：支持动态模型切换

如果想让同一个插件支持多模型，可以把输入参数扩展为：

[
  {
    "name": "prompt",
    "type": "string",
    "required": true,
    "description": "用户输入内容"
  },
  {
    "name": "model",
    "type": "string",
    "required": false,
    "description": "NixAPI 模型 ID"
  }
]

请求体改成：

{
  "model": "{{input.model|default('claude-sonnet-4-20250514')}}",
  "messages": [
    {
      "role": "user",
      "content": "{{input.prompt}}"
    }
  ]
}

这样同一个 Bot 可以根据场景选择不同模型。成本敏感的场景可以先对照 NixAPI 模型价格页 再设置默认模型。

---

常见问题

1. Coze 提示 Invalid request path

检查接口地址是否多了斜杠，推荐完整写成：

https://nixapi.com/v1/chat/completions

2. 报 401 Unauthorized

Key 无效或 Header 写法不对。Authorization 的值必须是 Bearer 加 API Key，中间有空格。

3. 报 model not found

模型名和 NixAPI 支持列表不一致。打开 NixAPI 支持的模型列表页 复制准确 ID。

4. 插件能调通，但 Bot 不调用

检查 Bot 的工具调用描述、触发条件和工作流节点。插件可用不代表 Bot 一定会自动选择它。

---

小结

Coze 接入 NixAPI 的核心是创建一个 HTTP API 插件，调用 https://nixapi.com/v1/chat/completions，并在 Header 中加入 NixAPI API Key。插件调通后，就可以把它挂到 Bot 或 Workflow 里，用统一接口扩展 Coze 的模型能力。