Coze API接口实战应用

Coze API介绍

• 概述 Coze API作为Coze平台对外的桥梁，让开发者能够灵活地利用Coze的功能和服务，促进业务流程自动化和系统集成。它覆盖了从数据获取到智能交互的全方位功能，旨在提升工作效率和创造更多可能。

Coze API申请接入流程

1. 发现API

– 通过API HUB查找AI相关API，找到Coze API并跳转访问Coze官方网站，注册开发者账号，填写必要的个人信息和公司信息。

2. 创建应用与密钥

• 登录到首页后创建Bot

• 打开API令牌管理页面添加新令牌

3. API配置

– 在个人访问令牌界面，配置所需API接口权限。

• Coze API的使用限制

当前扣子 API 免费供开发者使用，每个空间的 API 请求限额如下：​

QPS (每秒发送的请求数)：2​

QPM (每分钟发送的请求数)：60​

QPD (每天发送的请求数)：3000

• Coze API调用过程

发起对话

请求地址

POST https://api.coze.cn/open_api/v2/chat

curl --location --request POST 'https://api.coze.cn/open_api/v2/chat' \
--header 'Authorization: Bearer {{Personal_Access_Token}}' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Host: api.coze.cn' \
--header 'Connection: keep-alive' \
-d '{
    "conversation_id": "123",
    "bot_id": "{{Bot_Id}}",
    "user": "29032201862555",
    "query": "hello",
    "stream":flase
}'

{{Personal_Access_Token}}替换为前面申请的令牌

进入 Bot 的开发页面，开发页面 URL 中 bot 参数后的数字就是 Bot ID。例如https://www.coze.cn/space/73428668341****/bot/73428668*****，bot ID 为73428668*****。

示例

同时支持流式返回，仅需将stream参数置为ture

• Coze API的响应

data:{"event":"message","message":{"role":"assistant","type":"answer","content":"Hello","content_type":"text","extra_info":null},"is_finish":false,"index":0,"conversation_id":"123"}

data:{"event":"message","message":{"role":"assistant","type":"answer","content":"!","content_type":"text","extra_info":null},"is_finish":false,"index":0,"conversation_id":"123"}

...

data:{"event":"message","message":{"role":"assistant","type":"answer","content":"","content_type":"text","extra_info":null},"is_finish":true,"index":0,"conversation_id":"123"}

data:{"event":"done"}

Coze API的协议和格式

Coze的API使用HTTPS协议，返回值为JSON格式。支持流式和非流式数据返回

本指南旨在帮助开发者快速上手Coze API，了解从注册到实际调用的全过程，并掌握其在不同场景下的应用，以充分发挥Coze平台的潜能。