coze-apilisted

# Coze API 集成 Skill 扣子(Coze)是字节跳动推出的 AI 智能体开发平台,本 Skill 提供完整的 Coze API 调用指南。 ## 核心功能 1. **对话 API (Chat API)** - 与智能体进行对话 2. **工作流 API (Workflow API)** - 执行工作流 3. **消息管理** - 查询对话状态和消息列表 ## 快速开始 ### 1. 准备工作 在使用 Coze API 前需要完成以下准备: **获取访问令牌 (Personal Access Token)** 1. 登录 Coze 平台: https://www.coze.cn 2. 进入个人中心 → API 管理 3. 创建个人访问令牌(PAT) 4. 保存令牌(仅显示一次) **获取 Bot ID** 1. 进入 Bot 编辑页面 2. 从 URL 中获取 Bot ID - 例如: `https://www.coze.cn/space/123/bot/7348293334` - Bot ID 为: `7348293334` **发布 Bot 为 API 服务** 1. 在 Bot 页面点击"发布" 2. 选择"Bot as API" 3. 等待审核通过 ### 2. API 基础信息 **API 基础 URL** - 国内版: `https://api.coze.cn` - API 版本: v3(推荐) **认证方式** ``` Authorization: Bearer {YOUR_PAT_TOKEN} Content-Type: application/json ``` **使用限制** - 基础版: 每账号 100 次 API 调用(一次性) - 专业版: 无限制,按 Token 消耗计费 ## 对话 API (Chat API) ### 非流式对话 发起一次完整对话,等待完整结果后返回。 **API 端点** ``` POST https://api.coze.cn/v3/chat ``` **Python 示例代码** ```python import requests import json API_URL = "https://api.coze.cn/v3/chat" RETRIEVE_URL = "https://api.coze.cn/v3/chat/retrieve" MESSAGE_LIST_URL = "https://api.coze.cn/v3/chat/message/list" # 配置参数 PAT_TOKEN = "YOUR_PAT_TOKEN" BOT_ID = "YOUR_BOT_ID" USER_ID = "unique_user_id" def send_message(message): """发起对话""" headers = { "Authorization": f"Bearer {PAT_TOKEN}", "Content-Type": "application/json" } data = { "bot_id": BOT_ID, "user_id": USER_ID, "stream": False, "auto_save_history": True, "additiona