扣子（Coze）工作流调用中转 API 教程

# 扣子（Coze）工作流调用中转 API 教程

> 适用场景：在扣子（coze.cn）智能体的**工作流**里，通过「HTTP 请求」节点直接调用中转平台的 OpenAI 兼容对话接口。
>
> 接口地址：`https://api.zaimod.com`　请求路径：`/v1/chat/completions`

---

## 一、准备工作

开始前先确认手上已有这三样东西，后面填配置时直接照抄即可。

| 项目             | 取值 / 说明                                                          |
| -------------- | ---------------------------------------------------------------- |
| 接口地址（Base URL） | `https://api.zaimod.com`                                          |
| 对话接口完整地址       | `https://api.zaimod.com/v1/chat/completions`                      |
| 请求方法           | `POST`                                                           |
| API Key        | 在 `https://api.zaimod.com` 控制台创建，形如 `sk-xxxxxxxx`，**只显示一次，请先保存好** |
| 模型名称           | 示例用 `gpt-4o`，也可换成平台模型列表中支持的其他模型名                                 |

> 提示：接口地址只填域名 + 路径，**结尾不要带空格、不要漏掉 `/v1`**，否则节点会报 404。

---

## 二、操作步骤

### 步骤 1：创建一个智能体

1. 登录扣子，进入 **项目开发**（左侧导航）。
2. 点击右上角 **+ 项目**。
3. 在弹窗中选择 **创建智能体**。
4. 填写**智能体名称**、上传图标，点击 **确认**。

![](/uploads/editor/20261031/img_6ae5e0a0e013f2.01858971.png)

![](/uploads/editor/20261031/img_6ae5e0b1605d91.31597929.png)

---

### 步骤 2：新建一个工作流

1. 进入刚创建的智能体，在 **编排** 页面中找到 **工作流** 区块。
2. 点击该区块右侧的 **+**。
3. 在「添加工作流」弹窗中点击 **创建工作流**。
4. 填写**工作流名称**和**工作流描述**（描述写清楚用途，模型才知道何时调用它），点击 **确认**。

![](/uploads/editor/20261031/img_6ae5e0ce2a1505.25834338.png)

![](/uploads/editor/20261031/img_6ae5e0de3f2b18.98829383.png)

---

### 步骤 3：添加 HTTP 请求节点

1. 进入工作流画布，点击 **开始** 节点右侧的 **+**。
2. 在插件面板的搜索框中输入 `HTTP`。
3. 在 **组件** 分类下选择 **HTTP 请求**，节点即被添加到画布。
4. 把 **HTTP 请求** 节点的输出连线到 **结束** 节点。

![](/uploads/editor/20261031/img_6ae5e11261e771.30737115.png)

---

### 步骤 4：填写请求配置

配置 HTTP 请求节点有两种方式，推荐用第一种，一次粘贴全部填好。

#### 方式 A：导入 cURL（推荐）

点击节点面板右上角的 **导入 cURL**，把下面这段粘贴进去，点 **确认**，节点会自动填好 URL、请求头和请求体：

```bash
curl --location --request POST 'https://api.zaimod.com/v1/chat/completions' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer sk-你的APIKey' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "hi"
    }
  ],
  "max_tokens": 1000
}'
```

![](/uploads/editor/20261031/img_6ae5e1301b4f40.63152085.png)

#### 方式 B：手动填写

| 配置项      | 填写内容                                                                            |
| -------- | ------------------------------------------------------------------------------- |
| **API**  | 选择 `POST`，地址填 `https://api.zaimod.com/v1/chat/completions`                       |
| **请求参数** | 留空（模型名和消息都放在请求体里）                                                               |
| **请求头**  | `Content-Type` = `application/json`<br />`Authorization` = `Bearer sk-你的APIKey` |
| **请求体**  | 类型选 `JSON`，内容见下方                                                                |
| **超时设置** | 建议 `60` 秒以上，模型响应慢时可适当加大                                                         |

请求体（JSON）：

```json
{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": "hi"
    }
  ],
  "max_tokens": 1000
}
```

![](/uploads/editor/20261031/img_6ae5e13f502ce7.04712294.png)

> 关键点：
>
> - `Authorization` 的值必须带 `Bearer ` 前缀，且中间是一个空格，例如 `Bearer sk-abc123`。
> - 请求体类型下拉框要选 **JSON**，不要选 `none`。
> - 想接工作流输入时，把 `content` 的值改成引用开始节点的变量（如 `{{input}}`）即可。

---

### 步骤 5：试运行验证

1. 点击节点面板右上角的 **▶ 试运行**。
2. 输入框里填入测试内容（如 `hi`），点 **运行**。
3. 看到 `statusCode: 200`，且 `body` 中出现 `choices` 字段，即为调用成功。

![](/uploads/editor/20261031/img_6ae5e14c714c60.53982795.png)

成功返回结构示例：

```json
{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 12,
    "total_tokens": 22
  }
}
```

在 **结束** 节点（或后续节点）中引用模型回复时，取值路径为：

```
choices[0].message.content
```

---

## 三、配置速查表

| 参数              | 值                                           |
| --------------- | ------------------------------------------- |
| 方法              | `POST`                                      |
| URL             | `https://api.zaimod.com/v1/chat/completions` |
| `Content-Type`  | `application/json`                          |
| `Authorization` | `Bearer sk-你的APIKey`                        |
| `model`         | `gpt-4o`（或平台支持的其它模型）                        |
| `messages`      | `[{"role":"user","content":"你的问题"}]`        |
| `max_tokens`    | 单次回复的最大 token 数，如 `1000`                    |
| 回复取值路径          | `choices[0].message.content`                |

---

## 四、常见问题

| 现象                      | 原因与处理                                                                    |
| ----------------------- | ------------------------------------------------------------------------ |
| `401` / `Invalid token` | API Key 有误：检查是否多复制了空格、是否漏了 `Bearer ` 前缀、Key 是否已被删除或过期                    |
| `404` / `Not Found`     | URL 写错：确认是 `https://api.zaimod.com/v1/chat/completions`，不要漏 `/v1`，末尾不要有空格 |
| `400` / 参数错误            | 请求体不是合法 JSON（引号、逗号），或 `model` 名称不在平台支持列表中                                |
| 节点超时                    | 调大「超时设置」（如 120 秒）；或换用响应更快的模型                                             |
| 返回 200 但取不到内容           | 检查取值路径是否为 `choices[0].message.content`，必要时先用「JSON 反序列化」组件处理 body         |
| 提示连接失败                  | 该节点由云端出网访问，确认地址可公网直连；内网或私有地址无法访问                                         |

---

## 附：接口地址变更对照

| 位置       | 原地址                                         | 现地址                                         |
| -------- | ------------------------------------------- | ------------------------------------------- |
| 对话接口     | `http://api.zaimod.com/v1/chat/completions` | `https://api.zaimod.com/v1/chat/completions` |
| Base URL | `http://api.openlux.ai`                     | `https://api.zaimod.com`                     |

> Key 由新平台签发，迁移后请在 `https://api.zaimod.com` 重新生成并替换节点中的 `Authorization`。

上一篇：API 密钥令牌查询及兑换{else}上一篇：没有了下一篇：RikkaHub 配置教程{else}下一篇：没有了