Coze - CometAPI Documentation

Coze 是一个 AI 智能体和工作流构建平台。你可以通过两种方式将 CometAPI 连接到 Coze：使用原生的 CometAPI 插件（最简单），或使用通用的 HTTP Request 节点 以获得最大的灵活性。

前置条件

一个拥有有效 API key 的 CometAPI 账户 —— 在此获取
一个 Coze 账户 —— 在此注册

1

获取你的 CometAPI API key

登录 CometAPI 控制台。点击 Add API Key 并复制你的 sk-xxxxx key。

显示 Add API Key 按钮的 CometAPI 控制台

包含 base URL 的 CometAPI API key 详情

2

将 CometAPI 添加到 Coze 工作流

方法 1：CometAPI 插件（推荐）
方法 2：HTTP Request 节点

在 Coze 中，点击 Get Started 并创建一个新的工作流。
在工作流编辑器中，点击 Add Node → Plugins 并搜索 CometAPI。
将 CometAPI 插件节点添加到你的工作流中。

显示插件搜索的 Coze 工作流编辑器

搜索结果中显示的 CometAPI 插件

已添加到画布中的 CometAPI 插件节点

插件节点配置面板

在插件节点的 API Key 字段中，粘贴你的 sk-xxxxx key。
点击 Test 验证连接，然后点击 Publish。

已填写 API key 的插件节点

CometAPI 插件的测试成功结果

在 Coze 中创建一个智能体，然后在该智能体的工作流里，在 Start 和 End 节点之间添加一个 HTTP Request 节点。
设置如下内容：
- Method: POST
- URL: https://api.cometapi.com/v1/chat/completions
- Authentication Token: 粘贴你的 sk-xxxxx key，然后点击 Confirm
设置请求体：

{
  "model": "your-model-id",
  "messages": [
    {
      "role": "user",
      "content": "{{block_output_100001.input}}"
    }
  ],
  "stream": false
}

在 End 节点中，将输出设置为 HTTP 请求的响应体。将 your-model-id 替换为来自 CometAPI Models 页面的当前模型 ID。

已配置 URL 和认证 Token 的 HTTP Request 节点

在 HTTP 节点中配置的请求体 JSON

在 End 节点中选择 HTTP 响应体作为输出

所有节点均已连接的 Coze 工作流

3

测试并发布

在工作流中运行一条测试消息（例如询问当前时间）。如果 AI 成功回复，则说明集成已正常工作。发布该工作流即可正式上线。

显示测试成功响应的 Coze 工作流

已发布的 Coze 智能体正确响应

如果调用失败，请检查你的 API key 和端点 URL，或联系 CometAPI 支持。

对大多数用户，推荐使用插件方式——它会自动处理身份验证和响应解析。当你需要完全控制请求头，或想调用非聊天端点时，请使用 HTTP Request 节点。

前置条件