更新日志

创建智能体
更新智能体

2025年11月25日

新增参数

• 新增 api_mode 参数，用于指定智能体与模型交互时使用的 API 协议，包括 chat_api 和 responses_api。具体支持的模型请参见模型能力差异。
• 当 api_mode 为 responses_api时，parameters 参数支持配置前缀缓存、存储和存储时长。

语音合成

2025年11月21日

新增参数

新增 context_texts 参数，用于配置豆包语音合成大模型 2.0 音色的辅助信息，控制合成语音的整体情绪（如悲伤、生气）、方言（如四川话、北京话）、语气（如撒娇、暧昧、吵架、夹子音）、语速（快慢）及音调（高低）等。

双向流式语音合成事件
双向流式对话上行事件
Realtime 上行事件

2025年11月21日

新增参数

新增 data.tts_config.context_texts 参数，用于配置豆包语音合成大模型 2.0 音色的辅助信息，控制合成语音的整体情绪（如悲伤、生气）、方言（如四川话、北京话）、语气（如撒娇、暧昧、吵架、夹子音）、语速（快慢）及音调（高低）等。

恢复运行工作流

2025年11月18日

新增接口

当调用执行工作流 API 执行包含问答节点、输入节点的工作流时，智能体会以指定问题向用户提问，并等待用户回答。此时工作流为中断状态，开发者需要调用此 API 恢复运行工作流。

执行工作流
查询工作流异步运行结果

2025年11月18日

新增参数

新增 interrupt_data 参数，返回中断事件的详细信息，包含中断控制内容、中断类型和事件 ID 等信息。

修改企业员工的角色

2025年11月3日

新增接口

修改企业员工的角色。

创建组织

2025年11月3日

新增接口

在指定的企业中创建组织。

查询组织列表

2025年11月3日

新增接口

查询指定企业中的组织列表。

添加组织成员

2025年11月3日

新增接口

用户加入企业时将自动加入默认组织。创建组织后，你可以调用本 API 将员工和访客加入对应组织。

查询组织成员列表

2025年11月3日

新增接口

查询指定组织中的成员列表。

修改组织成员角色

2025年11月3日

新增接口

修改组织成员的角色。

修改组织基本信息

2025年10月27日

新增接口

修改组织的名称和描述。

修改工作空间基本信息

2025年10月27日

新增接口

修改工作空间的名称和描述。

查询套餐权益

2025年10月24日

新增接口

查询当前账号所属的套餐类型、扩容管理页面中 API 扩容的信息、通过 MCP 方式调用付费插件的次数限制。

批量查询插件信息

2025年10月24日

新增接口

批量查询插件的详细信息，支持查询官方插件、三方插件和资源库插件。

查询插件详情

2025年10月24日

新增参数

返回参数中新增 data.name_for_model、data.icon_url、data.is_call_available、data.created_at、data.updated_at。

查询付费插件列表

2025年10月24日

新增参数

Query 参数中新增 category_ids。

添加企业成员

2025年10月21日

新增接口

在火山引擎创建用户后，你可以调用本 API 将用户添加至企业。

移除组织成员

2025年10月21日

新增接口

如果成员因离职或换部门等场景需要调整归属的组织时，你可以调用本 API 将其移出组织。

移除企业成员

2025年10月21日

新增接口

移除企业成员，并指定资源接收人。

双向流式对话上行事件
双向流式对话下行事件
Realtime 上行事件
Realtime 下行事件

2025年10月16日

新增参数

企业旗舰版新增支持降噪配置，支持两种模式：

• data.voice_processing_config.enable_ans：主动噪声抑制。自动识别并过滤掉背景环境中的各种噪音（如键盘声、空调声、街道嘈杂声），让说话者的声音更清晰。
• data.voice_processing_config.enable_pdns：声纹降噪。专门针对特定说话人的声音进行优化，能更精准地保留目标人声。

双向流式对话上行事件
双向流式对话下行事件
Realtime 上行事件
Realtime 下行事件
创建房间

2025年10月16日

新增参数

企业旗舰版新增支持语义判停的自由对话模式（ data.turn_detection.type=semantic_vad） 。新增 data.turn_detection.semantic_vad_config 参数，用于配置判定语音停止的语义检测策略。

双向流式对话上行事件
双向流式对话下行事件

2025年10月15日

新增参数

data.output_audio.codec 输出音频编码新增支持 mp3 格式。新增 data.output_audio.mp3_config 参数，用于配置 mp3 编码参数。

查询付费插件列表

2025年9月29日

新增接口

查询插件商店中的付费插件列表，包括扣子官方插件和三方插件，或通过关键词模糊搜索相关插件。

查询插件分类

2025年9月29日

新增接口

获取插件的分类 ID，后续调用查询插件列表 API 查询指定分类下的插件。

查询插件详情

2025年9月29日

新增接口

查询指定插件的详细信息，包括插件工具列表（工具名称、描述、输入参数和返回参数），以及 MCP Server 的配置信息，以便在 Trae 等外部平台配置 MCP 服务，并调用插件工具。

调用插件工具

2025年9月29日

新增接口

调用指定付费插件中的工具。

创建房间

2025年9月17日

新增参数

新增 turn_detection 参数，语音检测类型新增支持按键说话模式。

Realtime 上行事件
Realtime 下行事件

2025年9月17日

新增事件

为支持按键说话模式，新增如下事件：

• input_audio_buffer.start：用户开始说话。
• input_audio_buffer.complete：用户结束说话。

创建房间
双向流式语音对话

2025年9月15日

参数下线

请求参数中的 workflow id 参数下线，存量 API 不受影响仍可正常使用。
如需为对话流中的自定义参数赋值， 请参见为自定义参数赋值。

申请插件扩容回调事件
插件扩容到期回调事件

2025年9月12日

新增接口

如果三方付费插件支持扩容，插件开发者可以订阅插件扩容回调事件。当用户申请插件扩容、扩容申请到期或用户主动取消扩容时，扣子开发平台会向指定的回调地址推送回调消息。

复制资源

2025年9月9日

新增接口

同工作空间或跨工作空间复制智能体、扣子应用或工作流。

查询资源复制的结果

2025年9月9日

新增接口

查询资源复制的结果。

Realtime 上行事件
Realtime 下行事件

2025年9月8日

新增参数

新增如下参数：

• data.asr_config.enable_nostream：是否开启二次识别模式，开启后会实时返回逐字识别的文本；当一句话结束时，会结合整句音频进行上下文分析并重新识别，生成优化后的识别结果并返回。
• data.asr_config.enable_emotion：是否开启识别说话人的情绪。
• data.asr_config.enable_gender：是否开启识别说话人的性别（male/female）。
• data.asr_config.sensitive_words_filter：配置敏感词过滤功能，支持以下 3 种过滤方式：
  • 过滤系统敏感词，并替换为*。
  • 过滤自定义敏感词，并替换为空。
  • 过滤自定义敏感词，并替换为*。

查询工作流基本信息

2025年9月4日

新增参数

返回参数中新增 input 和 output 参数，用于返回工作流开始节点的输入参数的结构体、结束节点的输出参数的结构体。

查询工作流的版本列表

2025年9月4日

新增参数

返回参数中新增 input 和 output 参数，用于返回工作流开始节点的输入参数的结构体、结束节点的输出参数的结构体。

双向流式对话上行事件
双向流式语音合成事件

2025年9月4日

新增参数

新增 data.output_audio.loudness_rate 参数，用于配置输出音频的音量。

Realtime 上行事件
语音合成

2025年9月4日

新增参数

新增 data.loudness_rate 参数，用于配置输入音频的音量。

查看智能体版本列表

2025年9月3日

新增接口

查询某个智能体的版本列表，支持查询已发布版本或未发布版本的版本号、版本创建者信息、创建时间等。

创建工作空间

2025年9月3日

新增接口

创建工作空间

开启或关闭智能体多人协作

2025年9月3日

新增接口

开启或关闭智能体多人协作模式。

开启或关闭工作流多人协作

2025年9月3日

新增接口

开启或关闭工作流多人协作模式。

添加智能体的协作者

2025年8月29日

新增接口

添加智能体的协作者。

添加应用的协作者

2025年8月29日

新增接口

添加应用的协作者。

删除智能体的协作者

2025年8月29日

新增接口

删除智能体的协作者。

删除应用的协作者

2025年8月29日

新增接口

删除应用的协作者。

添加工作流协作者

2025年8月29日

新增接口

添加工作流的协作者。

删除工作流协作者

2025年8月29日

新增接口

删除工作流的协作者。

发起对话

2025年8月29日

新增参数

新增 publish_status 和 bot_version 参数。

• publish_status：用于指定与已发布版本或草稿版本的智能体对话。
• bot_version：用于指定与某个特定版本的智能体对话。

绑定设备

2025年8月21日

新增接口

硬件厂商可以调用本 API 将企业内的硬件设备与企业的自定义渠道绑定，当开发者发布智能体到该自定义渠道时，在发布配置页面的设备列表中选择对应的设备，即可快速发布到对应设备。

发布智能体

2025年8月21日

新增参数

新增 connectors 参数，智能体发布自定义渠道时，你可以通过该参数传递自定义参数给渠道。例如，设置将智能体发布到指定设备。

更新会话名称

2025年8月4日

新增接口

会话创建者可以更新指定会话的会话名，以便更好地识别和管理会话。

删除会话

2025年8月4日

新增接口

会话创建者可以删除指定的会话。

创建会话

2025年8月4日

新增参数

请求参数新增 name 参数，用于指定会话的名称。
返回参数新增 creator_id 和 connector_id，返回会话的创建者 ID、会话在哪个渠道创建。

查看会话信息

2025年8月4日

新增参数

返回参数新增 name、creator_id 和 connector_id，返回会话的名称、会话的创建者 ID、会话在哪个渠道创建。

语音合成

2025年8月4日

新增参数

请求参数新增 emotion 和 emotion_scale，用于设置多情感音色的情感类型和情感值。

双向流式语音合成事件

2025年8月4日

新增参数

更新语音合成配置上行事件中，新增 data.output_audio.emotion_config 参数，用于设置多情感音色的情感类型和情感值。

双向流式对话上行事件

2025年8月4日

新增参数

更新对话配置上行事件中，新增 data.output_audio.emotion_config 参数，用于设置多情感音色的情感类型和情感值。

Realtime 上行事件

2025年8月4日

新增参数

更新房间配置上行事件中，新增 data.tts_config 参数，用于设置多情感音色的情感类型和情感值。

下架智能体

2025年7月25日

新增接口

智能体发布后，你可以调用本 API 从扣子官方渠道及自定义渠道下架智能体。

查询工作流列表

2025年7月24日

新增接口

查询指定工作空间中的工作流列表及其基本信息。

查询工作流基本信息

2025年7月24日

新增接口

查询工作流的基本信息，包括工作流名称、描述、创建者信息等。

查询工作流的版本列表

2025年7月24日

新增接口

查询某个工作流的所有历史版本记录，包括版本号、版本描述、操作者和发布时间。

执行工作流
执行工作流（流式响应）
查询工作流异步运行结果

2025年7月24日

新增参数

返回参数中新增 Usage 参数，返回本次 API 调用消耗的 Token 数量等信息。

创建回调应用

2025年7月22日

新增接口

创建回调应用，支持创建普通回调应用和渠道回调应用。订阅扣子回调功能时需要创建回调应用。

修改回调应用

2025年7月22日

新增接口

修改回调应用的名称和回调地址。

查询回调应用列表

2025年7月22日

新增接口

查询回调应用列表。

删除回调应用

2025年7月22日

新增接口

如果不再需要接收扣子回调，可以删除回调应用。一旦删除，该回调应用所订阅的所有回调事件触发时，将不再向该回调应用推送通知。

订阅回调事件

2025年7月22日

新增接口

订阅回调事件。

查询已订阅的事件

2025年7月22日

新增接口

查询回调应用中已订阅的事件。

取消订阅事件

2025年7月22日

新增接口

如果不再需要订阅某个回调事件，可以取消订阅。一旦取消订阅，对应回调事件触发时，将不再向该回调地址推送通知。

提交消息评价

2025年7月10日

新增接口

会话创建者可以对智能体或应用回复的消息提交评价，包括点赞、点踩和反馈详细的评论。

删除消息评价

2025年7月10日

新增接口

删除指定消息的评价。

查询文件夹列表

2025年7月8日

新增接口

工作空间中的用户可以查询工作空间中的文件夹列表。

查询文件夹详情

2025年7月8日

新增接口

工作空间中的用户可以查询工作空间中指定文件夹的详情，包括文件夹的名称、描述、所属工作空间、文件夹创建者的 UID等。

发起对话

2025年6月26日

新增参数

Body 中新增 enable_card 参数，用于设置问答节点返回的内容是否为卡片形式。

查看智能体列表

2025年6月18日

新增接口

查看指定空间的智能体列表，包含草稿状态的智能体和已发布的智能体。

查看智能体配置

2025年6月18日

新增接口

查看指定智能体的配置信息，包括草稿状态和已发布的智能体。

查看应用列表

2025年6月18日

新增接口

查看指定空间的应用列表。

查看空间成员列表

2025年6月18日

新增接口

查看指定空间的成员列表。

批量邀请用户加入空间

2025年6月18日

新增接口

批量邀请用户加入空间，并设置用户是空间管理员或空间成员。

批量移除空间中的用户

2025年6月18日

新增接口

将用户从指定的工作空间中移除。

查看空间列表

2025年6月18日

新增参数

在 Query 中新增 user_id 和 coze_account_id 参数，可以查看指定用户在指定组织下加入的工作空间。

查询输出节点的执行结果

2025年6月18日

新增接口

根据工作流的执行 ID 以及 查询工作流异步执行结果中返回的节点执行 uuid， 逐一查询节点每次执行的输出内容。

查询工作流异步运行结果

2025年6月18日

新增参数

新增 node_execute_status 参数，返回输出节点的运行情况。当输出节点的输出内容超过 1MB 时，会返回该字段。

更新对话配置

2025年5月07日

新增参数

• 新增 data.asr_config.enable_ddc 参数，用于设置是否开启语义顺滑功能。开启后，系统在语音处理时会自动去除识别结果中的 “啊”“嗯” 等语气词，使输出文本语义更流畅。
• 新增data.asr_config.enable_itn参数，用于设置在语音转文本时，是否进行文本纠错。
• 新增 data.asr_config.enable_punc 参数，用于设置在语音转文本时，是否给文本加上标点符号。

设置用户变量的值

2025年4月22日

新增接口

设置智能体或应用中的用户变量的值。

获取用户变量的值

2025年4月22日

新增接口

获取智能体或应用中设置的用户变量的值。

发起对话

2025年4月18日

新增参数

新增parameters 参数传入自定义参数的值。如果在对话流开始节点的输入参数中设置自定义参数，调用本接口发起对话时，可以通过parameters 参数传入对应的值等。

获取已发布智能体的配置（即将下线）

2025年4月17日

新增参数

• 新增 voice_info_list 参数，获取智能体的音色。
• 新增 background_image_info 参数，获取智能体背景的图片信息。

双向流式对话上行事件

2025年4月10日

新增参数

• chat.update 事件新增 interrupt_config 配置，支持语音指定关键词打断能力。
• chat.update 事件中的 asr_config 配置新增 user_language 配置，支持设置用户说话语种。
• chat.update 事件中新增 prologue_content 自定义开场白。

双向流式对话上行事件

2025年4月2日

新增参数

chat.update 事件新增 asr_config 配置，支持配置热词等。

创建会话

2025年3月21日

新增参数

创建会话时支持指定 bot_id，便于后续查看指定智能体的会话。

查看消息列表

2025年3月21日

新增参数

新增请求参数 order、chat_id、before_id、after_id 和 limit，用于筛选符合要求的消息。

清除上下文

2025年3月21日

新增 API

用于清除指定会话中存储的上下文消息。

查看会话列表

2025年3月21日

新增 API

查看用户与指定智能体的所有会话记录。

双向流式对话上行事件

2025年3月21日

新增事件

• 新增 input_audio_buffer.speech_started 事件，表示服务端识别到用户正在说话。
• 新增 input_audio_buffer.speech_stopped 事件，表示服务端识别到用户已停止说话。

2025年3月21日

新增参数

chat.update 事件新增 data.turn_detection 参数，用于配置对话中语音检测的相关参数，包括检测模式、检测到语音前收录的前置音频时长和持续静音时停止检测的时长。
新增 server_vad 能力。

2025年3月20日

新增参数

chat.update 事件新增 data.need_play_prologue 参数，用于配置是否播放开场白。

2025年3月19日

新增参数

chat.update 事件新增 data.event_subscriptions 参数，用于配置订阅下行事件。

2025年3月18日

新增参数

chat.update 事件新增
data.output_audio.pcm_config. frame_size_ms 参数，用于配置输出每包 pcm 音频的时长大小。
新增data.output_audio.pcm_config. limit_config 参数，用于配置输出音频限流，包括周期时长和周期内最大返回的 pcm 包数量。

Realtime 上行事件

2025年3月18日

新增事件

新增 mode.update 事件，更新房间模式和对话设置。

Realtime 下行事件

2025年3月18日

新增事件

新增 mode.updated 事件，当房间模式更新成功后，返回最新的房间模式设置。

添加发布平台

2025年3月3日

新增 API

为指定空间添加一个发布渠道。添加渠道后，空间中的每个开发者都可以将自己的 AI 项目发布到这些渠道中。

发起对话与消息管理相关 API

2025年2月20日

新增参数

以下 API 新增 reasoning_content 参数，表示 DeepSeek R1 模型的思维链。

• 发起对话
• 查看消息详情
• 查看消息列表
• 查看对话消息详情

上传文件

2025年2月19日

参数变更

支持上传多种文件格式，包括音频、视频、压缩文件等。

工作流相关 API

2025年2月10日

新增参数

执行工作流和执行工作流（流式响应）支持使用扣子的文件 ID 作为入参。

语音相关 API

2025年2月7日

新增 API

• 新增语音识别，支持将语音文件转为文字。
• 语音合成 API 正式开放，无需申请白名单。

创建智能体等智能体相关 API

2025年2月7日

新增参数

更新以下智能体相关 API，支持为智能体绑定工作流、插件和模型。

• 创建智能体
• 更新智能体
• 获取已发布智能体的配置（即将下线）

发起对话

2025年2月7日

新增参数

• object_string object 支持音频内容，对话时可输入语音文件或 URL。
• 新增参数 shortcut_command，支持 API 方式执行快捷指令。

更新审核结果

2025年1月9日

新增 API

更新智能体发布到自定义渠道的审核结果。

复刻音色等语音相关 API

2024年12月24日

新增 API

新增语音相关 API，用于智能语音通话场景。

• 复刻音色
• 查看音色列表
• 创建房间
• 语音合成

创建知识库文件

2024年12月16日

新增参数

新增 source_file_id 参数，向图片知识库中上传文件。

创建文本知识库等知识库 API

2024年12月16日

新增 API

新增知识库管理 API，包括创建知识库、查看知识库列表等。

• 创建文本知识库
• 查看知识库列表
• 修改知识库信息
• 删除知识库
• 查看知识库文件上传进度
• 更新知识库图片描述
• 查看知识库图片列表

执行对话流

2024年12月11日

新增 API

执行已发布的对话流。对话流是基于对话场景的特殊工作流，关于对话流的详细说明可参考工作流与对话流。

执行工作流

2024年10月30日

新增参数

扣子专业版用户调用此接口时，支持通过 is_async 参数异步运行工作流，适用于工作流执行耗时较长，导致运行超时的情况。异步运行时，工作流整体超时时间限制由 3 分钟延长至 24 小时，LLM 节点由 3 分钟延长至 5 分钟。

查询工作流异步运行结果

2024年10月30日

新增 API

调用接口执行工作流时，如果选择异步执行工作流，响应信息中会返回 execute_id，开发者可以通过本接口查询指定事件的执行结果。

涉及所有 API 接口

2024年10月15日

修改 PAT 有效期

2024年10月16日开始，新创建的个人访问密钥（PAT），有效期最长可设置为 30天。在此之前已创建的个人访问密钥有效期不受影响。

查看空间列表

2024年9月24日

新增 API

此 API 用于查看当前账号加入的空间列表。

删除消息

2024年9月2日

新增 API

此 API 用于删除指定会话中的消息。

发起对话

2024年9月2日

新增参数

发起对话接口增加请求参数 extra_params，通常用于特殊场景下指定一些必要参数供模型判断，例如指定经纬度，并询问智能体此位置的天气。

获取已发布智能体的配置（即将下线）

2024年9月2日

新增参数

获取已发布智能体的配置（即将下线）接口增加返回参数 knowledge，查看智能体详细配置时可查看智能体绑定的知识库列表。

• 消息相关 API：创建消息、查看消息列表、查看消息详情和修改消息
• 文件相关 API：上传文件、查看文件详情
• 会话相关 API：创建会话、查看会话信息
• 对话相关 API：查看对话详情、提交工具执行结果

2024年9月2日

修改权限点

对于2024年9月2号之后创建的 Access Token（包括个人访问密钥 PAT 和 OAuth 2.0 密钥），调用 API 之前必须根据 API 最新的权限要求完成授权，9月1日及之前创建的 Access Token，建议在10月1日之前添加新的权限点，以免影响 API 的正常使用。各个 API 的最新权限要求，可参考 API 文档中基础信息部分。

执行工作流（流式响应）

2024年8月21日

新增 API

此 API 用于执行包含流式节点的工作流，例如消息节点、结束节点等。接口响应方式为流式响应，开发者需要从流式事件中获取并拼接工作流的输出信息。

恢复运行工作流（流式响应）

2024年8月21日

新增 API

当执行到问答节点时，工作流会中断运行并发起询问，此时需要调用恢复运行工作流（流式响应）API 回复 Bot，并继续运行工作流。

创建智能体
更新智能体
发布智能体

2024年8月20日

新增 API

发布智能体管理相关接口，开发者可通过 API 方式创建 Bot、更新 Bot、发布智能体为 API 服务。

执行工作流

2024年8月16日

新增 API

此 API 用于执行一个已发布的工作流，接口响应方式为非流式响应。

取消进行中的对话

2024年8月7日

新增 API

调用发起对话接口时，如果对话触发了复杂的工作流、图像流，或模型处理数据量大时，对话可能耗时较久。对话进行中时，用户无法在此会话中发起新的对话。此时可以调用此接口取消正在进行中的对话，取消后，对话转为已取消状态（status=canceled），你可以在会话中创建新的对话。