Coze API SDK for Java 是一个扣子官方提供的 SDK 工具包,你可以通过 Java SDK 将扣子的 OpenAPI 集成到你的应用程序中。Coze Java SDK 支持所有扣子的官方鉴权方式,具备高度的灵活性和高可用性,显著提升 OpenAPI 的使用效率。你可以通过 maven 仓库快速安装 Coze Java SDK,用你的访问密钥初始化 SDK,然后就可以开始安全、高效地通过 OpenAPI 访问你的 AI 智能体。
Coze Java SDK 遵循用户友好的设计风格,可简化你的开发工作,且适用于所有技能水平开发者使用。
访问 GitHub 获取 Coze API SDK for Java 源码。
注意
从扣子 GitHub 仓库获取的源码和示例代码中,base_url 默认设置为域名 COZE_COM_BASE_URL,使用源码前应手动将其修改为域名 COZE_CN_BASE_URL。
Coze Java SDK 提供各种授权方式、各种使用方式的示例代码,便于开发者直接参考使用。
说明
常见场景的示例代码及说明如下:
|
模块 |
示例文件 |
说明 |
|---|---|---|
|
授权 |
通过个人访问密钥实现 OpenAPI 鉴权。 |
|
|
通过 OAuth 授权码方式实现授权与 OpenAPI 鉴权。 |
||
|
通过 OAuth JWT 方式实现授权与 OpenAPI 鉴权。 |
||
|
通过 OAuth PKCE 方式实现授权与 OpenAPI 鉴权。 |
||
|
通过 OAuth 设备码方式实现授权与 OpenAPI 鉴权。 |
||
|
对话 |
发起对话,响应方式为非流式响应。 |
|
|
发起对话,响应方式为流式响应。 |
||
|
发起对话,对话中上传文件,并发送多模态内容。 |
||
|
端插件。 |
||
|
会话与消息管理 |
创建会话。 |
|
|
查询会话列表。 |
||
|
创建、更新、删除消息。 |
||
|
查询指定对话中的消息列表。 |
||
|
工作流 |
运行工作流,响应方式为非流式响应。 |
|
|
运行工作流,响应方式为流式响应,且工作流中包含问答节点。 |
||
|
运行对话流。 |
||
|
异步运行工作流。 |
||
|
智能体管理 |
创建一个草稿状态的智能体,更新智能体,并发布智能体为 API 服务。 |
|
|
语音 |
RTC 音视频通话场景中,创建音视频房间。 |
|
|
语音合成,将文本转为语音,并将生成的语音保存为音频文件。 |
||
|
语音识别,将指定音频文件转录为文本。 |
||
|
克隆音色。 |
||
|
查询音色列表。 |
||
|
WebSocket 语音通话 |
WebSocket 语音通话。 |
|
|
语音合成,将文本转为语音,并将生成的语音保存为音频文件。 |
||
|
语音识别,将指定音频文件转录为文本。 |
||
|
工作空间 |
查询工作空间列表。 |
|
|
知识库 |
创建、更新和删除知识库。 |
|
|
查询指定工作空间下的知识库。 |
||
|
图片知识库管理,包含:
|
||
|
文本知识库管理,包含:
|
||
|
文件 |
文件上传,包含:
|
|
|
变量 |
变量管理,包含:
|
|
|
复制模板 |
复制商店中的模板到指定工作空间。 |
|
|
账单和权益额度 |
导出账单并查询账单文件。 |
|
|
创建、查询、更新硬件设备的权益额度。 |
||
|
异常处理 |
处理 API 异常。 |
|
|
客户端管理 |
修改日志级别。 |
|
|
设置请求超时时间。 |
||
|
初始化客户端。 |
当调用 API 失败时,SDK 会抛出 CozeAPIException 异常;当鉴权失败的时候,SDK 会抛出 CozeAuthException 异常。开发者可以根据自己的需求捕获对应的异常,其中 CozeAPIException 异常会获取到异常接口的错误码,API 错误码的相关说明及处理方式可参考错误码。