Coze 配置教程

在 Coze（扣子）里通过 HTTP/API 插件或工作流节点调用 Crazyrouter，并明确区分公开可用方案与企业版自定义模型方案

更新日期：2026-06-06

Coze（扣子）是字节跳动推出的智能体与工作流平台，适合做 Bot、工作流编排、插件调用和多渠道发布。对接 Crazyrouter 时，最稳妥、最适合公开文档的路径，不是直接假设“所有版本都能自定义模型”，而是优先走 HTTP / API 插件或工作流 HTTP 请求节点。

先说结论

对于绝大多数 Crazyrouter 用户，Coze 当前更推荐这两条路：

方案 1：通过 基于 API 创建 的插件调用 Crazyrouter

方案 2：在工作流里通过 HTTP 请求节点调用 Crazyrouter

不建议把“直接在 Coze 模型管理里接入 Crazyrouter 自定义模型”写成公开主线教程，原因是：

不同版本、不同区域、不同套餐的 Coze 能力差异较大

扣子当前官方套餐文档明确提到，自定义模型 属于企业旗舰版能力之一

因此对公开文档来说，更稳妥的主线应该是 HTTP / API 插件路线

Warning: 这页最重要的准确性原则是：把 Coze 的公开主线写成“HTTP / API 插件调用 Crazyrouter”，而不是默认所有用户都能直接在模型管理里挂自定义上游。

适合谁用

想在 Coze Bot 或工作流里接入 Crazyrouter 的用户

想把 Crazyrouter 作为外部模型调用节点的人

想先做最小可验证链路，而不是一上来就走企业版自定义模型能力的人

想让 Bot 通过插件或工作流访问多模型能力的人

系统要求与前置条件

项目	说明
Crazyrouter 账号	先在 crazyrouter.com 注册
Crazyrouter token	建议为 Coze 单独创建一个 token
Coze 账号	需要可创建 Bot / 工作流 / 插件
发布能力	至少能调试 Bot 或工作流
可用模型	至少放行 1 个聊天模型

建议初始白名单：

gpt-5.5

claude-opus-4-8

gemini-3.1-pro

方案 1：通过 API 插件接入 Crazyrouter

第 1 步：在 Crazyrouter 创建 Coze 专用 token

第一次只建议放行：

gpt-5.5

claude-opus-4-8

先不要一开始就开放太多模型，排障会更简单。

第 2 步：在 Coze 创建 API 插件

进入 Coze 工作台后，按你当前版本的界面进入：

插件

创建插件

选择 基于 API 创建 或相近名称入口

Note: Coze 的界面名称可能因版本、区域或产品线不同而略有变化，但核心思路都是：创建一个对外 HTTP API 的插件。

第 3 步：配置请求方法与 URL

填写：

Method: POST

URL: https://api.crazyrouter.com/v1/chat/completions

第 4 步：配置请求头

填写：

Authorization: Bearer sk-xxx
Content-Type: application/json

第 5 步：配置最小请求体

第一次建议先用最小请求体：

{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "{{input}}"
    }
  ]
}

如果你的插件界面支持参数映射，可以把用户输入映射到 {{input}} 这类占位变量。

第 6 步：先在插件里做连接验证

如果当前版本支持调试插件，先传入一句：

Reply only OK

确认接口先能稳定返回，再继续挂到 Bot 或工作流里。

第 7 步：在 Bot 或工作流里调用插件

当插件单独测试通过后，再把它加入：

Bot 插件能力

或工作流节点

第一次建议先让插件只承担一个简单任务，例如摘要、改写或固定问答。

方案 2：通过工作流 HTTP 请求节点接入 Crazyrouter

如果你不想单独维护插件，也可以在工作流里直接调用 HTTP 请求节点。

关于“自定义模型接入”应该怎么理解

Coze 的一些版本或套餐确实可能支持自定义模型接入，但这不应作为 Crazyrouter 公开文档里的默认主线。

原因：

扣子官方套餐 FAQ 当前把 自定义模型 列为企业旗舰版能力之一

对大多数普通用户来说，公开可复现、最容易验证的仍是 HTTP / API 插件路线

因此这页只把自定义模型能力作为补充背景，不把它写成默认公开教程

使用场景	推荐模型	原因
首轮链路验证	`gpt-5.5`	2026 年 3 月 23 日已在生产环境实测成功，最适合先确认 Coze 到 Crazyrouter 的调用链路
高质量输出	`claude-opus-4-8`	适合更强解释和内容生成
Gemini 备用档	`gemini-3.1-pro`	适合作为第二条兼容性验证路径

Token 设置最佳实践

设置	建议	说明
专用 token	必须	Coze 不要和桌面客户端、IDE 工具共用 token
模型白名单	强烈建议	先只放行 1 到 2 个模型
配额上限	强烈建议	工作流循环、插件重试会放大消耗
环境隔离	建议	dev / test / production 分开 token
泄露处理	立即轮换	插件截图、共享工作区暴露后应立即换 key

验证清单

已创建 Coze 专用 Crazyrouter token

已优先选择 HTTP / API 插件或工作流 HTTP 请求节点路线

请求 URL 已设置为 https://api.crazyrouter.com/v1/chat/completions

Authorization 头已正确填写 Bearer sk-xxx

Content-Type 已设置为 application/json

最小请求体已用 gpt-5.5 验证成功

插件或节点单独调试成功

再挂入 Bot / 工作流后也能成功运行

Crazyrouter 后台日志中能看到对应请求

常见错误与修复

现象	常见原因	修复方式
401 unauthorized	token 错误、过期或复制不完整	重新生成 token 并重新填写 `Authorization` 头
404	URL 写错，或少了 `/v1/chat/completions`	改成完整 URL
403 / model not allowed	token 未放行当前模型	在 Crazyrouter token 设置中放行模型
`model not found`	模型名写错	先改回 `gpt-5.5` 重新验证
插件可创建但 Bot 中调用失败	插件输入 / 输出映射不一致	先回退到固定字符串调试
工作流节点偶发失败	节点输入过长、重试过多或并发过高	先缩小输入，降低复杂度做最小验证
跟着别人的教程找不到“模型管理接入”	版本或套餐不同	回到 HTTP / API 插件主线，不要先依赖企业版能力

FAQ

Coze 接 Crazyrouter 最推荐哪条路？

公开文档里，优先推荐 HTTP / API 插件或工作流 HTTP 请求节点路线。

为什么不把“自定义模型接入”写成主线？

因为 Coze 不同版本和套餐能力差异较大，官方套餐 FAQ 也把 自定义模型 作为企业旗舰版能力之一。公开文档更适合写可复现、门槛更低的 HTTP 路线。

URL 应该填什么？

填 https://api.crazyrouter.com/v1/chat/completions。

第一个推荐模型是什么？

先用 gpt-5.5。

什么时候再增加 Claude 或更多模型？

先把单模型、单节点、单任务跑通，再逐步扩大模型白名单。

Note: 如果你的目标是“让 Coze 先稳定调用 Crazyrouter”，最重要的不是追求最复杂的接法，而是先用 HTTP / API 插件把最小链路跑通。

原教程截图

最后校验/修改：2026-09-28（API Base URL 由 cn.crazyrouter.com 统一改为 https://api.crazyrouter.com，共 5 处；账号/控制台仍为 https://crazyrouter.com）

coze 工作流使用 Crazyrouter API 教程

Coze 配置教程

先说结论

适合谁用

推荐接法

公开主线：HTTP / API 插件路线

为什么先推荐这条路

系统要求与前置条件

方案 1：通过 API 插件接入 Crazyrouter

第 1 步：在 Crazyrouter 创建 Coze 专用 token

第 2 步：在 Coze 创建 API 插件

第 3 步：配置请求方法与 URL

第 4 步：配置请求头

第 5 步：配置最小请求体

第 6 步：先在插件里做连接验证

第 7 步：在 Bot 或工作流里调用插件

方案 2：通过工作流 HTTP 请求节点接入 Crazyrouter

推荐配置

推荐验证顺序

关于“自定义模型接入”应该怎么理解

推荐模型配置

Token 设置最佳实践

验证清单

常见错误与修复

FAQ

Coze 接 Crazyrouter 最推荐哪条路？

为什么不把“自定义模型接入”写成主线？

URL 应该填什么？

第一个推荐模型是什么？

什么时候再增加 Claude 或更多模型？

原教程截图

coze 工作流使用 Crazyrouter API 教程

Coze 配置教程#

先说结论#

适合谁用#

推荐接法#

公开主线：HTTP / API 插件路线#

为什么先推荐这条路#

系统要求与前置条件#

方案 1：通过 API 插件接入 Crazyrouter#

第 1 步：在 Crazyrouter 创建 Coze 专用 token#

第 2 步：在 Coze 创建 API 插件#

第 3 步：配置请求方法与 URL#

第 4 步：配置请求头#

第 5 步：配置最小请求体#

第 6 步：先在插件里做连接验证#

第 7 步：在 Bot 或工作流里调用插件#

方案 2：通过工作流 HTTP 请求节点接入 Crazyrouter#

推荐配置#

推荐验证顺序#

关于“自定义模型接入”应该怎么理解#

推荐模型配置#

Token 设置最佳实践#

验证清单#

常见错误与修复#

FAQ#

Coze 接 Crazyrouter 最推荐哪条路？#

为什么不把“自定义模型接入”写成主线？#

URL 应该填什么？#

第一个推荐模型是什么？#

什么时候再增加 Claude 或更多模型？#

原教程截图#

Coze 配置教程

先说结论

适合谁用

推荐接法

公开主线：HTTP / API 插件路线

为什么先推荐这条路

系统要求与前置条件

方案 1：通过 API 插件接入 Crazyrouter

第 1 步：在 Crazyrouter 创建 Coze 专用 token

第 2 步：在 Coze 创建 API 插件

第 3 步：配置请求方法与 URL

第 4 步：配置请求头

第 5 步：配置最小请求体

第 6 步：先在插件里做连接验证

第 7 步：在 Bot 或工作流里调用插件

方案 2：通过工作流 HTTP 请求节点接入 Crazyrouter

推荐配置

推荐验证顺序

关于“自定义模型接入”应该怎么理解

推荐模型配置

Token 设置最佳实践

验证清单

常见错误与修复

FAQ

Coze 接 Crazyrouter 最推荐哪条路？

为什么不把“自定义模型接入”写成主线？

URL 应该填什么？

第一个推荐模型是什么？

什么时候再增加 Claude 或更多模型？

原教程截图