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

先说结论

对于绝大多数 Crazyrouter 用户,Coze 当前更推荐这两条路:
  • 方案 1:通过 基于 API 创建 的插件调用 Crazyrouter
  • 方案 2:在工作流里通过 HTTP 请求节点调用 Crazyrouter
不建议把“直接在 Coze 模型管理里接入 Crazyrouter 自定义模型”写成公开主线教程,原因是:
  • 不同版本、不同区域、不同套餐的 Coze 能力差异较大
  • 扣子当前官方套餐文档明确提到,自定义模型 属于企业旗舰版能力之一
  • 因此对公开文档来说,更稳妥的主线应该是 HTTP / API 插件路线
这页最重要的准确性原则是:把 Coze 的公开主线写成“HTTP / API 插件调用 Crazyrouter”,而不是默认所有用户都能直接在模型管理里挂自定义上游。

适合谁用

  • 想在 Coze Bot 或工作流里接入 Crazyrouter 的用户
  • 想把 Crazyrouter 作为外部模型调用节点的人
  • 想先做最小可验证链路,而不是一上来就走企业版自定义模型能力的人
  • 想让 Bot 通过插件或工作流访问多模型能力的人

推荐接法

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

推荐参数:
  • 请求方法:POST
  • URL:https://api.crazyrouter.com/v1/chat/completions
  • Header:
    • Authorization: Bearer sk-xxx
    • Content-Type: application/json
  • 首个验证模型:gpt-5.5

为什么先推荐这条路

因为它:
  • 最不依赖 Coze 套餐差异
  • 最容易定位是“Coze 配置问题”还是“Crazyrouter token / 模型问题”
  • 最适合在公开文档里做稳定说明

系统要求与前置条件

建议初始白名单:
  • gpt-5.5
  • claude-opus-4-8
  • gemini-3.1-pro

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

1

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

第一次只建议放行:
  • gpt-5.5
  • claude-opus-4-8
先不要一开始就开放太多模型,排障会更简单。
2

第 2 步:在 Coze 创建 API 插件

进入 Coze 工作台后,按你当前版本的界面进入:
  • 插件
  • 创建插件
  • 选择 基于 API 创建 或相近名称入口
Coze 的界面名称可能因版本、区域或产品线不同而略有变化,但核心思路都是:创建一个对外 HTTP API 的插件。
3

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

填写:
  • Method: POST
  • URL: https://api.crazyrouter.com/v1/chat/completions
4

第 4 步:配置请求头

填写:
5

第 5 步:配置最小请求体

第一次建议先用最小请求体:
如果你的插件界面支持参数映射,可以把用户输入映射到 {{input}} 这类占位变量。
6

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

如果当前版本支持调试插件,先传入一句:
确认接口先能稳定返回,再继续挂到 Bot 或工作流里。
7

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

当插件单独测试通过后,再把它加入:
  • Bot 插件能力
  • 或工作流节点
第一次建议先让插件只承担一个简单任务,例如摘要、改写或固定问答。

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

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

推荐配置

  • 请求方法:POST
  • URL:https://api.crazyrouter.com/v1/chat/completions
  • Headers:
    • Authorization: Bearer sk-xxx
    • Content-Type: application/json
  • Body:

推荐验证顺序

  1. 先在节点里传固定字符串 Reply only OK
  2. 再改成变量输入
  3. 最后再把输出映射到后续节点

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

Coze 的一些版本或套餐确实可能支持自定义模型接入,但这不应作为 Crazyrouter 公开文档里的默认主线。 原因:
  • 扣子官方套餐 FAQ 当前把 自定义模型 列为企业旗舰版能力之一
  • 对大多数普通用户来说,公开可复现、最容易验证的仍是 HTTP / API 插件路线
  • 因此这页只把自定义模型能力作为补充背景,不把它写成默认公开教程

推荐模型配置

Token 设置最佳实践

验证清单

  • 已创建 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 后台日志中能看到对应请求

常见错误与修复

FAQ

Coze 接 Crazyrouter 最推荐哪条路?

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

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

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

URL 应该填什么?

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

第一个推荐模型是什么?

先用 gpt-5.5

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

先把单模型、单节点、单任务跑通,再逐步扩大模型白名单。
如果你的目标是“让 Coze 先稳定调用 Crazyrouter”,最重要的不是追求最复杂的接法,而是先用 HTTP / API 插件把最小链路跑通。