Coze 接入 apizt API 教程
适用范围:扣子工作流通过 HTTP 节点调用非流式 Chat Completions,代码节点解析正文。
版本与验证:2026-09-28 核对本文配置项、步骤和资料入口,补齐验证与排错说明。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| 请求方法 | POST | HTTP 节点发送聊天请求。 |
| URL | https://api.apizt.com/v1/chat/completions | 完整聊天端点。 |
| Authorization | Bearer <apizt API Key> | 配置在后台 Header 中。 |
| model / stream | gpt-6-sol / false | JSON 请求体。 |
| 响应正文 | 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;流式模式需要另行适配。
怎样确认配置已生效
- HTTP 返回成功,解析节点的 answer 非空。
- 结束节点只返回 answer,不包含请求凭据。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| body 解析报错 | 确认请求 stream 为 false,检查 HTTP 状态与响应是否为 JSON。 |
| 提示词包含引号导致失败 | 用 JSON.stringify 生成 body_json 并整体引用,不手工拼接 JSON。 |
| 结束节点没有内容 | 将 answer 输出引用到结束节点,不误选 HTTP 原始 body。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。