Coze（扣子）自定义模型接入 Ace Data Cloud

Coze 的“自定义模型”可以按模型实际支持的协议接入 Ace Data Cloud。本教程不绑定某个模型；核心原则是：模型 ID、协议和 API 地址必须来自同一个 Ace Data Cloud API 契约，不能跨模型家族拼接。

获取 API Token

前往 Ace Data Cloud 控制台 获取 API Token。一个 Token 可以调用账户已开通的服务。

配置前先确认三项信息

打开目标模型在 Ace Data Cloud 的开发文档，记录：

  1. 模型 ID：例如 glm-5.2、claude-opus-4-8。
  2. 协议：Coze 当前表单中常见的是 OpenAI Chat Completions 或 Anthropic Messages。
  3. API 地址：使用开发文档给出的完整请求地址，不根据模型名称自行猜测。

下面是已由 Ace Data Cloud 仓库 OpenAPI 确认的两个示例：

模型家族 Coze 中选择的协议 API 地址 模型 ID 示例
GLM OpenAI Chat Completions https://api.acedata.cloud/glm/chat/completions glm-5.2
Claude Anthropic Messages https://api.acedata.cloud/v1/messages 以 Claude Messages 文档 当前列表为准

这张表只表示这两个公开 API 的文档契约，不代表所有模型都能共用其中任一地址。接入其它模型时，应查看对应服务文档。

在 Coze 中填写

在 Coze 的模型管理页面添加“自定义模型”，按目标 API 的契约填写：

Coze 字段 填写规则
模型展示名称 自定义，仅用于界面显示
模型 ID 与 Ace Data Cloud 开发文档完全一致
模型协议 与目标 API 契约一致，不按模型用途猜测
API URL 对应开发文档给出的地址
API Key Ace Data Cloud API Token

如果 Coze 表单在 URL 右侧显示自动追加的固定路径，请检查最终地址，避免重复出现 /v1/messages 或 /chat/completions。第三方 UI 可能随版本变化，本文只约束最终请求必须匹配 Ace Data Cloud 的公开 API 地址。

高级配置

  • 输入长度和最大回复长度优先使用 Coze 的“服务商默认”或表单默认值。Ace Data Cloud OpenAPI 未声明的模型上限不在本文中猜测。
  • “图片理解”、工具调用等能力应按具体模型文档开启；首次排障建议先做纯文本请求。
  • Header 覆盖保持为空，除非目标 API 文档明确要求额外 Header。

最小验证

保存后，在 Coze 对话页选择新模型，发送：

只回复 COZE_OK

收到 COZE_OK 后，再启用图片、工具调用或更大的上下文设置。

如果 Coze 只显示“模型请求失败”，先在本机直接请求同一个 API，以区分 Ace Data Cloud API 问题与 Coze 配置问题。以下以 GLM 为例，会产生少量模型用量：

curl -sS 'https://api.acedata.cloud/glm/chat/completions' \
  -H "Authorization: Bearer $ACEDATACLOUD_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "glm-5.2",
    "messages": [{"role": "user", "content": "Reply with exactly: COZE_OK"}],
    "max_tokens": 128
  }'

截图中的 GLM-5.2 为什么失败

截图里同时出现了：

  • 模型 ID：glm-5.2
  • 协议：Anthropic Messages
  • 最终路径：/v1/messages

这与 Ace Data Cloud 为 GLM 发布的 OpenAI Chat Completions 契约 /glm/chat/completions 不一致。应先改为：

  • 协议：OpenAI Chat Completions
  • API URL：https://api.acedata.cloud/glm/chat/completions
  • 模型 ID：glm-5.2

这里能确认的是配置与公开契约不一致；Coze 没有在截图中展示底层 HTTP 请求和响应，因此不能仅凭截图断言唯一根因。若改正后三项仍失败，应结合浏览器网络请求或 Ace Data Cloud 使用历史 继续定位。

证据与边界

  • GLM 的 endpoint、Bearer 鉴权和模型枚举来自 Ace Data Cloud 的 GLM OpenAPI 与 GLM 开发文档。
  • Claude Messages 的 endpoint 和模型枚举来自 Ace Data Cloud 的 Claude Messages OpenAPI 与 Claude Messages 文档。
  • Coze 的字段名称来自用户提供的当前界面截图。Coze 官方页面在本次审计环境中无法可靠抓取，因此本文不声称未验证的字段拼接、Header 生成或版本上限行为。

相关链接