Coze 接入 apizt API 教程

官方入口:扣子中文官网

更新于

适用范围:扣子工作流通过 HTTP 节点调用非流式 Chat Completions,代码节点解析正文。

版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。未在真实账号中验证付费模型调用。

配置速查

配置项填写内容注意事项
请求方法POSTHTTP 节点发送聊天请求。
URLhttps://api.apizt.com/v1/chat/completions完整聊天端点。
AuthorizationBearer <apizt API Key>配置在后台 Header 中。
model / streamgpt-6-sol / falseJSON 请求体。
响应正文choices[0].message.content先解析 HTTP body,再取正文。

还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key

为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。

第 1 步:创建项目与工作流

登录扣子,新建项目并添加工作流。开始节点新增 prompt(String,必填),用于接收用户问题。

第 2 步:准备 JSON 请求体

添加代码节点,输入 prompt 引用开始节点变量,输出 body_json(String)。

async function main({ params }) {
  const prompt = String(params.prompt || '').trim();
  if (!prompt) throw new Error('prompt 不能为空');
  return { body_json: JSON.stringify({
    model: 'gpt-6-sol', stream: false,
    messages: [{ role: 'user', content: prompt }]
  }) };
}

第 3 步:添加 HTTP 请求

添加 HTTP 节点,方法 POST,URL 填 https://api.apizt.com/v1/chat/completions。Headers 添加 Authorization:Bearer 你的apizt令牌 和 Content-Type:application/json。请求体选择 raw text,引用整个 body_json,Content-Type 保持 application/json,不额外包引号;凭据保留在后台节点配置中。

第 4 步:解析响应正文

HTTP 输出的 body 可能是 String。在后续代码节点声明 body 输入,引用 HTTP body;输出 answer(String),使用下方代码取正文,不直接把原始 JSON 作为回答。

async function main({ params }) {
  const body = typeof params.body === 'string' ? JSON.parse(params.body) : params.body;
  const answer = body?.choices?.[0]?.message?.content;
  if (typeof answer !== 'string' || !answer.trim()) {
    throw new Error('响应没有聊天正文,请检查 HTTP 状态和错误体');
  }
  return { answer };
}

第 5 步:连接结束节点并试运行

结束节点新增 answer 输出并引用解析节点的 answer。试运行输入一个短问题,确认 HTTP 成功、解析输出非空、结束节点返回文本。本文非流式链路不能直接处理 SSE;流式模式需要另行适配。

Coze 聊天 HTTP 请求;apizt 配置示意图
Coze 聊天 HTTP 请求。原创配置示意图,字段位置以所装版本为准;演示密钥无效。点击图片可在页内放大,支持关闭按钮、点击图片外区域和 Esc 关闭。

怎样确认配置已生效

  1. HTTP 返回成功,解析节点的 answer 非空。
  2. 结束节点只返回 answer,不包含请求凭据。

接入失败时逐项检查

现象检查与处理
body 解析报错确认请求 stream 为 false,检查 HTTP 状态与响应是否为 JSON。
提示词包含引号导致失败用 JSON.stringify 生成 body_json 并整体引用,不手工拼接 JSON。
结束节点没有内容将 answer 输出引用到结束节点,不误选 HTTP 原始 body。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。