news 2026/6/21 3:01:09

[智能体-476]：Coze 扣子 v3/chat 智能体 API curl 全套示例（国内域名 api.coze.cn）

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
[智能体-476]：Coze 扣子 v3/chat 智能体 API curl 全套示例（国内域名 api.coze.cn）

前置准备（所有示例通用）

  1. 获取 PAT 令牌：Coze 后台 → 个人中心 → API 管理 → 创建个人访问令牌（pat_xxxx）
  2. bot_id：智能体发布 API 后，Bot 编辑页 URL 末尾数字
  3. 国内接口地址：https://api.coze.cn/v3/chat
  4. 核心区分：流式 SSE（AI 对话主流）、非流式一次性返回、多轮会话上下文

一、流式 SSE curl（最常用，对应 RESTful HTTP+SSE 长连接）

完整可直接执行命令

bash

运行

curl -N --location POST https://api.coze.cn/v3/chat \ -H "Authorization: Bearer pat_你的PAT密钥" \ -H "Content-Type: application/json" \ -H "Accept: text/event-stream" \ -d '{ "bot_id": "替换为你的bot_id", "user_id": "user_001", "conversation_id": "conv_00001", "stream": true, "auto_save_history": true, "additional_messages": [ { "role": "user", "content_type": "text", "content": "帮我查询南京今日天气，并给出出行穿搭建议" } ] }'

关键参数解释

  1. -N / --no-buffer：关闭 curl 输出缓存，SSE 分片实时打印，实现打字机效果（流式必备）
  2. Accept: text/event-stream：告知服务端客户端支持 SSE 事件流，开启分段推送
  3. "stream": true：开启 AI 增量流式输出
  4. conversation_id：固定 ID 维持云端会话上下文，多轮对话自动记忆历史

终端返回 SSE 数据流示例

plaintext

data: {"id":"chat_xxxx","type":"thought","delta":{"content":"需要调用天气插件获取南京气温"}} data: {"id":"chat_xxxx","type":"tool_call","delta":{"tool_name":"天气查询","params":"{\"city\":\"南京\"}"}} data: {"id":"chat_xxxx","type":"message","delta":{"content":"南京今日22~28℃，多云微风，"}} data: {"id":"chat_xxxx","type":"message","delta":{"content":"推荐短袖搭配薄防晒外套，适合短途骑行。"}} data: {"id":"chat_xxxx","type":"done"}

二、多轮上下文会话 curl（复用conversation_id）

复用同一会话 ID，智能体自动读取上一轮天气信息，无需重复提问：

bash

运行

curl -N --location POST https://api.coze.cn/v3/chat \ -H "Authorization: Bearer pat_你的PAT密钥" \ -H "Content-Type: application/json" \ -H "Accept: text/event-stream" \ -d '{ "bot_id": "替换为你的bot_id", "user_id": "user_001", "conversation_id": "conv_00001", "stream": true, "auto_save_history": true, "additional_messages": [ { "role": "user", "content_type": "text", "content": "那今天适合户外骑行吗？" } ] }'

三、非流式一次性返回（短问答，无 SSE）

去掉-N与Accept: text/event-stream，stream: false，等待 AI 生成完整后一次性输出 JSON：

bash

运行

curl --location POST https://api.coze.cn/v3/chat \ -H "Authorization: Bearer pat_你的PAT密钥" \ -H "Content-Type: application/json" \ -d '{ "bot_id": "替换为你的bot_id", "user_id": "user_001", "stream": false, "auto_save_history": true, "additional_messages": [ { "role": "user", "content_type": "text", "content": "你好，介绍下你的功能" } ] }'

四、单行压缩版流式 curl（适合脚本复制）

bash

运行

curl -N -L POST https://api.coze.cn/v3/chat -H "Authorization: Bearer pat_xxx" -H "Content-Type: application/json" -H "Accept: text/event-stream" -d '{"bot_id":"123456","user_id":"u001","conversation_id":"conv001","stream":true,"auto_save_history":true,"additional_messages":[{"role":"user","content_type":"text","content":"讲一段简短小故事"}]}'

五、调试专用 curl（-v 打印完整请求 / 响应日志）

排查 401 鉴权、流式失效、路由报错时使用：

bash

运行

curl -N -v --location POST https://api.coze.cn/v3/chat \ -H "Authorization: Bearer pat_你的PAT密钥" \ -H "Content-Type: application/json" \ -H "Accept: text/event-stream" \ -d '{ "bot_id": "替换为你的bot_id", "user_id": "user_001", "stream": true, "additional_messages": [{"role":"user","content_type":"text","content":"测试调试接口"}] }'

六、配套常用辅助接口 curl 示例

1. 创建会话（v1/conversation/create）

手动新建独立会话，拿到专属 conversation_id：

bash

运行

curl --location POST https://api.coze.cn/v1/conversation/create \ -H "Authorization: Bearer pat_你的PAT密钥" \ -H "Content-Type: application/json" \ -d '{ "meta_data": {"client": "curl调试"}, "messages": [] }'

2. 查询对话完整结果（v3/chat/retrieve）

流式对话结束后，拉取完整对话记录：

bash

运行

curl --location 'https://api.coze.cn/v3/chat/retrieve?conversation_id=会话ID&chat_id=对话ID' \ -H "Authorization: Bearer pat_你的PAT密钥" \ -H "Content-Type: application/json"

七、核心关键点（区分传统本地函数调用）

  1. 全程远程 HTTP 网络请求，不是本机内存函数调用，必须鉴权 Token、网络域名；
  2. 流式依赖-N与 SSE 头，逐分片实时输出，本地函数一次性阻塞返回；
  3. conversation_id云端持久存储对话上下文，普通本地函数无会话记忆能力；
  4. 单次请求自动执行：意图识别→插件工具调用→知识库检索→LLM 生成完整智能体链路。

八、常见报错排查

  1. 401 Unauthorized：PAT 密钥错误、Bearer 后缺少空格
  2. 404 Not Found：智能体未发布 API、bot_id 填写错误
  3. 无实时打字输出：缺失-N或Accept: text/event-stream请求头
  4. 上下文丢失：每次请求conversation_id不一致，每次新建会话
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/21 2:59:58

Weyl半金属的拓扑特性与强相互作用效应研究

1. Weyl半金属的拓扑特性与强相互作用效应1.1 Weyl半金属的基本特性Weyl半金属是近年来凝聚态物理领域备受关注的一类拓扑量子材料。这类材料的独特之处在于其能带结构中存在被称为Weyl点的简并点，这些点在动量空间中成对出现，每个对中的两个点具有相反的…

作者头像 李华
网站建设 2026/6/21 2:58:41

5分钟掌握N_m3u8DL-RE：新手也能轻松下载加密流媒体

5分钟掌握N_m3u8DL-RE：新手也能轻松下载加密流媒体 【免费下载链接】N_m3u8DL-RE Cross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文. 项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE …

作者头像 李华
网站建设 2026/6/21 2:56:25

基于RS乘积码构造大最小距离子码：原理、方法与工程实践

1. 项目概述：从经典纠错码到高性能子码构造在数字通信和数据存储的世界里，错误无处不在。信道噪声、硬件故障、宇宙射线，都可能让一串精心编排的“0”和“1”在传输过程中面目全非。纠错码，就是对抗这种信息熵增的“铠甲”。其中&…

作者头像 李华
网站建设 2026/6/21 2:45:55

多视图融合溯源图入侵检测：从数据采集到威胁狩猎的实战架构

1. 从“单线叙事”到“立体侦查”：为什么我们需要多视图融合的入侵检测在安全运营中心（SOC）待过几年的朋友，大概都经历过这样的场景：凌晨三点，告警平台突然弹出一条“高威胁”告警，显示某台Web服…

作者头像 李华
网站建设 2026/6/21 2:44:42

联邦知识蒸馏与LLM增强：破解跨域推荐中的数据孤岛与语义鸿沟

1. 项目概述：当推荐系统遇上数据孤岛与语义鸿沟在推荐系统这个老生常谈的领域里，我们这些从业者最头疼的问题，往往不是模型不够新、算力不够强，而是数据本身带来的“先天不足”。想象一下，你手上有两个业务平台&#x…

作者头像 李华
网站建设 2026/6/21 2:40:20

Playwright MCP：5分钟掌握AI浏览器自动化的终极指南

Playwright MCP：5分钟掌握AI浏览器自动化的终极指南 【免费下载链接】playwright-mcp Playwright MCP server 项目地址: https://gitcode.com/gh_mirrors/pl/playwright-mcp Playwright MCP 是微软官方推出的革命性浏览器自动化服务器，它通过标准…

作者头像 李华