> ## Documentation Index > Fetch the complete documentation index at: https://docs.coze.cn/llms.txt > Use this file to discover all available pages before exploring further. ## 2025年11月 {#06b97336} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[创建智能体](/developer_guides/create_bot) |\ |[更新智能体](/developer_guides/update_bot) |2025年11月25日 |新增参数 |* 新增 `api_mode` 参数，用于指定智能体与模型交互时使用的 API 协议，包括 `chat_api` 和 `responses_api`。具体支持的模型请参见[模型能力差异](https://www.coze.cn/open/docs/developer_guides/model_api_param_support)。 |\ | | | |* 当 `api_mode` 为 `responses_api`时，`parameters` 参数支持配置前缀缓存、存储和存储时长。 | | | | | | \ |[语音合成](/developer_guides/text_to_speech) |2025年11月21日 |新增参数 |新增 `context_texts` 参数，用于配置豆包语音合成大模型 2.0 音色的辅助信息，控制合成语音的整体情绪（如悲伤、生气）、方言（如四川话、北京话）、语气（如撒娇、暧昧、吵架、夹子音）、语速（快慢）及音调（高低）等。 | | | | | | \ |[双向流式语音合成事件](/developer_guides/tts_event) |\ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |\ |[Realtime 上行事件](/developer_guides/signaling_uplink_event) |2025年11月21日 |新增参数 |新增 `data.tts_config.context_texts` 参数，用于配置豆包语音合成大模型 2.0 音色的辅助信息，控制合成语音的整体情绪（如悲伤、生气）、方言（如四川话、北京话）、语气（如撒娇、暧昧、吵架、夹子音）、语速（快慢）及音调（高低）等。 | | | | | | \ |[恢复运行工作流](/developer_guides/resume_workflow) |2025年11月18日 |新增接口 |当调用[执行工作流](https://www.coze.cn/open/docs/developer_guides/workflow_run) API 执行包含问答节点、输入节点的工作流时，智能体会以指定问题向用户提问，并等待用户回答。此时工作流为中断状态，开发者需要调用此 API 恢复运行工作流。 | | | | | | \ |[执行工作流](/developer_guides/workflow_run) |\ |[查询工作流异步运行结果](/developer_guides/workflow_history) |2025年11月18日 |新增参数 |新增 `interrupt_data` 参数，返回中断事件的详细信息，包含中断控制内容、中断类型和事件 ID 等信息。 | | | | | | \ |[修改企业员工的角色](/developer_guides/update_enterprise_people) |2025年11月3日 |新增接口 |修改企业员工的角色。 | | | | | | \ |[创建组织](/developer_guides/create_organization) |2025年11月3日 |新增接口 |在指定的企业中创建组织。 | | | | | | \ |[查询组织列表](/developer_guides/list_organization) |2025年11月3日 |新增接口 |查询指定企业中的组织列表。 | | | | | | \ |[添加组织成员](/developer_guides/add_organization_people) |2025年11月3日 |新增接口 |用户加入企业时将自动加入默认组织。[创建组织](https://www.coze.cn/open/docs/developer_guides/add_organization_people)后，你可以调用本 API 将员工和访客加入对应组织。 | | | | | | \ |[查询组织成员列表](/developer_guides/list_organization_people) |2025年11月3日 |新增接口 |查询指定组织中的成员列表。 | | | | | | \ |[修改组织成员角色](/developer_guides/update_organization_people) |2025年11月3日 |新增接口 |修改组织成员的角色。 | ## 2025年10月 {#1b92dfa1} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[修改组织基本信息](/developer_guides/update_organization_info) |2025年10月27日 |新增接口 |修改组织的名称和描述。 | | | | | | \ |[修改工作空间基本信息](/developer_guides/update_workspace_info) |2025年10月27日 |新增接口 |修改工作空间的名称和描述。 | | | | | | \ |[查询套餐权益](/developer_guides/get_benefit) |2025年10月24日 |新增接口 |查询当前账号所属的套餐类型、扩容管理页面中 API 扩容的信息、通过 MCP 方式调用付费插件的次数限制。 | | | | | | \ |[批量查询插件信息](/developer_guides/batch_get_plugins_info) |2025年10月24日 |新增接口 |批量查询插件的详细信息，支持查询官方插件、三方插件和资源库插件。 | | | | | | \ |[查询插件详情](/developer_guides/get_plugin) |2025年10月24日 |新增参数 |返回参数中新增 `data.name_for_model`、`data.icon_url`、`data.is_call_available`、`data.created_at`、`data.updated_at`。 | | | | | | \ |[查询付费插件列表](/developer_guides/list_plugin) |2025年10月24日 |新增参数 |Query 参数中新增 `category_ids`。 | | | | | | \ |[添加企业成员](/developer_guides/add_enterprise_member) |2025年10月21日 |新增接口 |在火山引擎创建用户后，你可以调用本 API 将用户添加至企业。 | | | | | | \ |[移除组织成员](/developer_guides/remove_organization_member) |2025年10月21日 |新增接口 |如果成员因离职或换部门等场景需要调整归属的组织时，你可以调用本 API 将其移出组织。 | | | | | | \ |[移除企业成员](/developer_guides/remove_enterprise_member) |2025年10月21日 |新增接口 |移除企业成员，并指定资源接收人。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |\ |[双向流式对话下行事件](/developer_guides/streaming_chat_downlink_event) |\ |[Realtime 上行事件](/developer_guides/signaling_uplink_event) |\ |[Realtime 下行事件](/developer_guides/signaling_downlink_event) |2025年10月16日 |新增参数 |**企业旗舰版**新增支持降噪配置，支持两种模式： |\ | | | | |\ | | | |* `data.voice_processing_config.enable_ans`：主动噪声抑制。自动识别并过滤掉背景环境中的各种噪音（如键盘声、空调声、街道嘈杂声），让说话者的声音更清晰。 |\ | | | |* `data.voice_processing_config.enable_pdns`：声纹降噪。专门针对**特定说话人**的声音进行优化，能更精准地保留目标人声。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |\ |[双向流式对话下行事件](/developer_guides/streaming_chat_downlink_event) |\ |[Realtime 上行事件](/developer_guides/signaling_uplink_event) |\ |[Realtime 下行事件](/developer_guides/signaling_downlink_event) |\ |[创建房间](/developer_guides/create_room) |2025年10月16日 |新增参数 |**企业旗舰版**新增支持语义判停的自由对话模式（ `data.turn_detection.type=semantic_vad`） 。新增 `data.turn_detection.semantic_vad_config` 参数，用于配置判定语音停止的语义检测策略。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |\ |[双向流式对话下行事件](/developer_guides/streaming_chat_downlink_event) |\ | |2025年10月15日 |新增参数 |`data.output_audio.codec` 输出音频编码新增支持 mp3 格式。新增 `data.output_audio.mp3_config` 参数，用于配置 mp3 编码参数。 |\ | | | | | ## 2025年9月 {#87470651} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[查询付费插件列表](/developer_guides/list_plugin) |2025年9月29日 |新增接口 |查询插件商店中的付费插件列表，包括扣子官方插件和三方插件，或通过关键词模糊搜索相关插件。 | | | | | | \ |[查询插件分类](/developer_guides/list_plugin_category) |2025年9月29日 |新增接口 |获取插件的分类 ID，后续调用[查询插件列表](https://www.coze.cn/open/docs/developer_guides/list_plugin) API 查询指定分类下的插件。 | | | | | | \ |[查询插件详情](/developer_guides/get_plugin) |2025年9月29日 |新增接口 |查询指定插件的详细信息，包括插件工具列表（工具名称、描述、输入参数和返回参数），以及 MCP Server 的配置信息，以便在 Trae 等外部平台配置 MCP 服务，并调用插件工具。 | | | | | | \ |[调用插件工具](/developer_guides/call_plugin_tool) |2025年9月29日 |新增接口 |调用指定付费插件中的工具。 | | | | | | \ |[创建房间](/developer_guides/create_room) |2025年9月17日 |新增参数 |新增 `turn_detection` 参数，语音检测类型新增支持按键说话模式。 | | | | | | \ |[Realtime 上行事件](/developer_guides/signaling_uplink_event) |\ |[Realtime 下行事件](/developer_guides/signaling_downlink_event) |2025年9月17日 |新增事件 |为支持按键说话模式，新增如下事件： |\ | | | | |\ | | | |* `input_audio_buffer.start`：用户开始说话。 |\ | | | |* `input_audio_buffer.complete`：用户结束说话。 | | | | | | \ |[创建房间](/developer_guides/create_room) |\ |[双向流式语音对话](/developer_guides/streaming_chat_api) |2025年9月15日 |参数下线 |请求参数中的 workflow id 参数下线，存量 API 不受影响仍可正常使用。 |\ | | | |如需为对话流中的自定义参数赋值， 请参见[为自定义参数赋值](/tutorial/variable)。 | | | | | | \ |[申请插件扩容回调事件](/developer_guides/benefit_plugin_scale_requested) |\ |[插件扩容到期回调事件](/developer_guides/benefit_plugin_scale_expired) |2025年9月12日 |新增接口 |如果三方付费插件支持扩容，插件开发者可以订阅插件扩容回调事件。当用户申请插件扩容、扩容申请到期或用户主动取消扩容时，扣子开发平台会向指定的回调地址推送回调消息。 | | | | | | \ |[复制资源](/developer_guides/copy_resource_task) |2025年9月9日 |新增接口 |同工作空间或跨工作空间复制智能体、扣子应用或工作流。 | | | | | | \ |[查询资源复制的结果](/developer_guides/query_resource_copy_execution_result) |2025年9月9日 |新增接口 |查询资源复制的结果。 | | | | | | \ |[Realtime 上行事件](/developer_guides/signaling_uplink_event) |\ |[Realtime 下行事件](/developer_guides/signaling_downlink_event) |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 种过滤方式： |\ | | | | * 过滤系统敏感词，并替换为`*`。 |\ | | | | * 过滤自定义敏感词，并替换为空。 |\ | | | | * 过滤自定义敏感词，并替换为`*`。 | | | | | | \ |[查询工作流基本信息](/developer_guides/get_workflow_info) |2025年9月4日 |新增参数 |返回参数中新增 `input` 和 `output` 参数，用于返回工作流开始节点的输入参数的结构体、结束节点的输出参数的结构体。 | | | | | | \ |[查询工作流的版本列表](/developer_guides/list_workflow_version) |2025年9月4日 |新增参数 |返回参数中新增 `input` 和 `output` 参数，用于返回工作流开始节点的输入参数的结构体、结束节点的输出参数的结构体。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |\ |[双向流式语音合成事件](/developer_guides/tts_event) |2025年9月4日 |新增参数 |新增 `data.output_audio.loudness_rate` 参数，用于配置输出音频的音量。 | | | | | | \ |[Realtime 上行事件](/developer_guides/signaling_uplink_event) |\ |[语音合成](/developer_guides/text_to_speech) |2025年9月4日 |新增参数 |新增 `data.loudness_rate` 参数，用于配置输入音频的音量。 | | | | | | \ |[查看智能体版本列表](/developer_guides/list_bot_versions) |2025年9月3日 |新增接口 |查询某个智能体的版本列表，支持查询已发布版本或未发布版本的版本号、版本创建者信息、创建时间等。 | | | | | | \ |[创建工作空间](/developer_guides/create_workspace) |2025年9月3日 |新增接口 |创建工作空间 | | | | | | \ |[开启或关闭智能体多人协作](/developer_guides/switch_bot_develop_mode) |2025年9月3日 |新增接口 |开启或关闭智能体多人协作模式。 | | | | | | \ |[开启或关闭工作流多人协作](/developer_guides/switch_workflow_develop_mode) |2025年9月3日 |新增接口 |开启或关闭工作流多人协作模式。 | ## 2025年8月 {#29ffa9fc} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[添加智能体的协作者](/developer_guides/add_bot_collaborator) |2025年8月29日 |新增接口 |添加智能体的协作者。 | | | | | | \ |[添加应用的协作者](/developer_guides/add_app_collaborator) |2025年8月29日 |新增接口 |添加应用的协作者。 | | | | | | \ |[删除智能体的协作者](/developer_guides/remove_bot_collaborator) |2025年8月29日 |新增接口 |删除智能体的协作者。 | | | | | | \ |[删除应用的协作者](/developer_guides/remove_app_collaborator) |2025年8月29日 |新增接口 |删除应用的协作者。 | | | | | | \ |[添加工作流协作者](/developer_guides/add_workflow_collaborator) |2025年8月29日 |新增接口 |添加工作流的协作者。 | | | | | | \ |[删除工作流协作者](/developer_guides/remove_workflow_collaborator) |2025年8月29日 |新增接口 |删除工作流的协作者。 | | | | | | \ |[发起对话](/developer_guides/chat_v3) |2025年8月29日 |新增参数 |新增` publish_status` 和 `bot_version` 参数。 |\ | | | | |\ | | | |* `publish_status`：用于指定与已发布版本或草稿版本的智能体对话。 |\ | | | |* `bot_version`：用于指定与某个特定版本的智能体对话。 | | | | | | \ |[绑定设备](/developer_guides/bind_connector_config) |2025年8月21日 |新增接口 |硬件厂商可以调用本 API 将企业内的硬件设备与企业的自定义渠道绑定，当开发者发布智能体到该自定义渠道时，在发布配置页面的设备列表中选择对应的设备，即可快速发布到对应设备。 | | | | | | \ |[发布智能体](/developer_guides/publish_bot) |2025年8月21日 |新增参数 |新增 `connectors` 参数，智能体发布自定义渠道时，你可以通过该参数传递自定义参数给渠道。例如，设置将智能体发布到指定设备。 | | | | | | \ |[更新会话名称](/developer_guides/edit_conversation) |2025年8月4日 |新增接口 |会话创建者可以更新指定会话的会话名，以便更好地识别和管理会话。 | | | | | | \ |[删除会话](/developer_guides/delete_conversation) |2025年8月4日 |新增接口 |会话创建者可以删除指定的会话。 | | | | | | \ |[创建会话](/developer_guides/create_conversation) |2025年8月4日 |新增参数 |请求参数新增 `name` 参数，用于指定会话的名称。 |\ | | | |返回参数新增 `creator_id` 和 `connector_id`，返回会话的创建者 ID、会话在哪个渠道创建。 | | | | | | \ |[查看会话信息](/developer_guides/retrieve_conversation) |2025年8月4日 |新增参数 |返回参数新增 `name`、`creator_id` 和 `connector_id`，返回会话的名称、会话的创建者 ID、会话在哪个渠道创建。 | | | | | | \ |[语音合成](/developer_guides/text_to_speech) |2025年8月4日 |新增参数 |请求参数新增 `emotion` 和 `emotion_scale`，用于设置多情感音色的情感类型和情感值。 | | | | | | \ |[双向流式语音合成事件](/developer_guides/tts_event) |2025年8月4日 |新增参数 |更新语音合成配置上行事件中，新增 `data.output_audio.emotion_config` 参数，用于设置多情感音色的情感类型和情感值。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |2025年8月4日 |新增参数 |更新对话配置上行事件中，新增 `data.output_audio.emotion_config` 参数，用于设置多情感音色的情感类型和情感值。 | | | | | | \ |[Realtime 上行事件](/developer_guides/signaling_uplink_event) |2025年8月4日 |新增参数 |更新房间配置上行事件中，新增 `data.tts_config` 参数，用于设置多情感音色的情感类型和情感值。 | ## 2025年7月 {#2a93cae6} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[下架智能体](/developer_guides/unpublish_agent) |2025年7月25日 |新增接口 |智能体发布后，你可以调用本 API 从扣子官方渠道及自定义渠道下架智能体。 | | | | | | \ |[查询工作流列表](/developer_guides/get_workflow_list) |2025年7月24日 |新增接口 |查询指定工作空间中的工作流列表及其基本信息。 | | | | | | \ |[查询工作流基本信息](/developer_guides/get_workflow_info) |2025年7月24日 |新增接口 |查询工作流的基本信息，包括工作流名称、描述、创建者信息等。 | | | | | | \ |[查询工作流的版本列表](/developer_guides/list_workflow_version) |2025年7月24日 |新增接口 |查询某个工作流的所有历史版本记录，包括版本号、版本描述、操作者和发布时间。 | | | | | | \ |[执行工作流](/developer_guides/workflow_run) |\ |[执行工作流（流式响应）](/developer_guides/workflow_stream_run) |\ |[查询工作流异步运行结果](/developer_guides/workflow_history) |2025年7月24日 |新增参数 |返回参数中新增 `Usage` 参数，返回本次 API 调用消耗的 Token 数量等信息。 | | | | | | \ |[创建回调应用](/developer_guides/create_callback_app) |2025年7月22日 |新增接口 |创建回调应用，支持创建普通回调应用和渠道回调应用。订阅扣子回调功能时需要创建回调应用。 | | | | | | \ |[修改回调应用](/developer_guides/update_callback_app) |2025年7月22日 |新增接口 |修改回调应用的名称和回调地址。 | | | | | | \ |[查询回调应用列表](/developer_guides/list_callback_app) |2025年7月22日 |新增接口 |查询回调应用列表。 | | | | | | \ |[删除回调应用](/developer_guides/delete_callback_app) |2025年7月22日 |新增接口 |如果不再需要接收扣子回调，可以删除回调应用。一旦删除，该回调应用所订阅的所有回调事件触发时，将不再向该回调应用推送通知。 | | | | | | \ |[订阅回调事件](/developer_guides/subscribe_callback_message) |2025年7月22日 |新增接口 |订阅回调事件。 | | | | | | \ |[查询已订阅的事件](/developer_guides/list_subscribed_callback_message) |2025年7月22日 |新增接口 |查询回调应用中已订阅的事件。 | | | | | | \ |[取消订阅事件](/developer_guides/unsubscribe_callback_message) |2025年7月22日 |新增接口 |如果不再需要订阅某个回调事件，可以取消订阅。一旦取消订阅，对应回调事件触发时，将不再向该回调地址推送通知。 | | | | | | \ |[提交消息评价](/developer_guides/message_feedback) |2025年7月10日 |新增接口 |会话创建者可以对智能体或应用回复的消息提交评价，包括点赞、点踩和反馈详细的评论。 | | | | | | \ |[删除消息评价](/developer_guides/delete_message_feedback) |2025年7月10日 |新增接口 |删除指定消息的评价。 | | | | | | \ |[查询文件夹列表](/developer_guides/workspace_list_folder) |2025年7月8日 |新增接口 |工作空间中的用户可以查询工作空间中的文件夹列表。 | | | | | | \ |[查询文件夹详情](/developer_guides/workspace_read_folder) |2025年7月8日 |新增接口 |工作空间中的用户可以查询工作空间中指定文件夹的详情，包括文件夹的名称、描述、所属工作空间、文件夹创建者的 UID等。 | ## 2025年6月 {#ea3b8d29} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[发起对话](/developer_guides/chat_v3) |2025年6月26日 |新增参数 |Body 中新增 `enable_card` 参数，用于设置问答节点返回的内容是否为卡片形式。 | | | | | | \ |[查看智能体列表](/developer_guides/bots_list_draft_published) |2025年6月18日 |新增接口 |查看指定空间的智能体列表，包含草稿状态的智能体和已发布的智能体。 | | | | | | \ |[查看智能体配置](/developer_guides/get_metadata_draft_published) |2025年6月18日 |新增接口 |查看指定智能体的配置信息，包括草稿状态和已发布的智能体。 | | | | | | \ |[查看应用列表](/developer_guides/published_apps_list) |2025年6月18日 |新增接口 |查看指定空间的应用列表。 | | | | | | \ |[查看空间成员列表](/developer_guides/list_space_member) |2025年6月18日 |新增接口 |查看指定空间的成员列表。 | | | | | | \ |[批量邀请用户加入空间](/developer_guides/add_space_member) |2025年6月18日 |新增接口 |批量邀请用户加入空间，并设置用户是空间管理员或空间成员。 | | | | | | \ |[批量移除空间中的用户](/developer_guides/remove_space_member) |2025年6月18日 |新增接口 |将用户从指定的工作空间中移除。 | | | | | | \ |[查看空间列表](/developer_guides/list_workspace) |2025年6月18日 |新增参数 |在 `Query` 中新增 `user_id` 和 `coze_account_id` 参数，可以查看指定用户在指定组织下加入的工作空间。 | | | | | | \ |[查询输出节点的执行结果](/developer_guides/get_node_execute_history_response) |2025年6月18日 |新增接口 |根据工作流的执行 ID 以及 [查询工作流异步执行结果](https://www.coze.cn/open/docs/developer_guides/workflow_history)中返回的节点执行 uuid， 逐一查询节点每次执行的输出内容。 | | | | | | \ |[查询工作流异步运行结果](/developer_guides/workflow_history) |2025年6月18日 |新增参数 |新增 `node_execute_status` 参数，返回输出节点的运行情况。当输出节点的输出内容超过 1MB 时，会返回该字段。 | ## 2025年5月 {#05207f73} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[更新对话配置](https://www.coze.cn/open/docs/developer_guides/streaming_chat_event#71628d9c) |2025年5月07日 |新增参数 |* 新增 `data.asr_config.enable_ddc` 参数，用于设置是否开启语义顺滑功能。开启后，系统在语音处理时会自动去除识别结果中的 “啊”“嗯” 等语气词，使输出文本语义更流畅。 |\ | | | |* 新增`data.asr_config.enable_itn`参数，用于设置在语音转文本时，是否进行文本纠错。 |\ | | | |* 新增 `data.asr_config.enable_punc` 参数，用于设置在语音转文本时，是否给文本加上标点符号。 | ## 2025年4月 {#11f2d107} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[设置用户变量的值](/developer_guides/update_variable) |2025年4月22日 |新增接口 |设置智能体或应用中的用户变量的值。 | | | | | | \ |[获取用户变量的值](/developer_guides/read_variable) |2025年4月22日 |新增接口 |获取智能体或应用中设置的用户变量的值。 | | | | | | \ |[发起对话](/developer_guides/chat_v3) |2025年4月18日 |新增参数 |新增`parameters` 参数传入自定义参数的值。如果在对话流开始节点的输入参数中设置自定义参数，调用本接口发起对话时，可以通过`parameters` 参数传入对应的值等。 | | | | | | \ |[获取已发布智能体的配置（即将下线）](/developer_guides/get_metadata) |2025年4月17日 |新增参数 |* 新增 `voice_info_list` 参数，获取智能体的音色。 |\ | | | |* 新增 `background_image_info` 参数，获取智能体背景的图片信息。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |2025年4月10日 |新增参数 |* `chat.update` 事件新增 interrupt_config 配置，支持语音指定关键词打断能力。 |\ | | | |* `chat.update` 事件中的 asr_config 配置新增 user_language 配置，支持设置用户说话语种。 |\ | | | |* `chat.update` 事件中新增 prologue_content 自定义开场白。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |2025年4月2日 |新增参数 |`chat.update` 事件新增 asr_config 配置，支持配置热词等。 | ## 2025年3月 {#51e8b8e4} | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |2025年3月24日 |新增音频编码 |输入的音频格式支持 `g711` 格式。 | |---|---|---|---| | | | | | \ |[创建会话](/developer_guides/create_conversation) |2025年3月21日 |新增参数 |创建会话时支持指定 bot_id，便于后续查看指定智能体的会话。 | | | | | | \ |[查看消息列表](/developer_guides/list_message) |2025年3月21日 |新增参数 |新增请求参数 order、chat_id、before_id、after_id 和 limit，用于筛选符合要求的消息。 | | | | | | \ |[清除上下文](/developer_guides/clear_conversation_context) |2025年3月21日 |新增 API |用于清除指定会话中存储的上下文消息。 | | | | | | \ |[查看会话列表](/developer_guides/list_conversations) |2025年3月21日 |新增 API |查看用户与指定智能体的所有会话记录。 | | | | | | \ |[双向流式对话上行事件](/developer_guides/streaming_chat_event) |\ | |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 上行事件](/developer_guides/signaling_uplink_event) |2025年3月18日 |新增事件 |新增 `mode.update` 事件，更新房间模式和对话设置。 | | | | | | \ |[Realtime 下行事件](/developer_guides/signaling_downlink_event) |2025年3月18日 |新增事件 |新增 `mode.updated` 事件，当房间模式更新成功后，返回最新的房间模式设置。 | ## 2025年2月 {#767aefc4} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[添加发布平台](/developer_guides/install_channel) |2025年3月3日 |新增 API |为指定空间添加一个发布渠道。添加渠道后，空间中的每个开发者都可以将自己的 AI 项目发布到这些渠道中。 | ## 2025年2月 {#30ceb28a} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[发起对话](/developer_guides/chat_v3)与消息管理相关 API |2025年2月20日 |新增参数 |以下 API 新增 reasoning_content 参数，表示 DeepSeek R1 模型的思维链。 |\ | | | | |\ | | | |* [发起对话](/developer_guides/chat_v3) |\ | | | |* [查看消息详情](/developer_guides/retrieve_message) |\ | | | |* [查看消息列表](/developer_guides/list_message) |\ | | | |* [查看对话消息详情](/developer_guides/list_chat_messages) | | | | | | \ |[上传文件](/developer_guides/upload_files) |2025年2月19日 |参数变更 |支持上传多种文件格式，包括音频、视频、压缩文件等。 | | | | | | \ |工作流相关 API |2025年2月10日 |新增参数 |[执行工作流](/developer_guides/workflow_run)和[执行工作流（流式响应）](/developer_guides/workflow_stream_run)支持使用扣子的文件 ID 作为入参。 | | | | | | \ |语音相关 API |2025年2月7日 |新增 API |* 新增[语音识别](/developer_guides/audio_transcriptions)，支持将语音文件转为文字。 |\ | | | |* [语音合成](/developer_guides/text_to_speech) API 正式开放，无需申请白名单。 | | | | | | \ |[创建智能体](/developer_guides/create_bot)等智能体相关 API |2025年2月7日 |新增参数 |更新以下智能体相关 API，支持为智能体绑定工作流、插件和模型。 |\ | | | | |\ | | | |* [创建智能体](/developer_guides/create_bot) |\ | | | |* [更新智能体](/developer_guides/update_bot) |\ | | | |* [获取已发布智能体的配置（即将下线）](/developer_guides/get_metadata) | | | | | | \ |[发起对话](/developer_guides/chat_v3) |2025年2月7日 |新增参数 |* object_string object 支持音频内容，对话时可输入语音文件或 URL。 |\ | | | |* 新增参数 shortcut_command，支持 API 方式执行快捷指令。 | ## 2025年1月 {#075c64f5} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[更新审核结果](/developer_guides/update_review_result) |2025年1月9日 |新增 API |更新智能体发布到自定义渠道的审核结果。 | ## 2024年12月 {#ae63fcb9} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[复刻音色](/developer_guides/clone_voices)等语音相关 API |2024年12月24日 |新增 API |新增语音相关 API，用于智能语音通话场景。 |\ | | | | |\ | | | |* [复刻音色](/developer_guides/clone_voices) |\ | | | |* [查看音色列表](/developer_guides/list_voices) |\ | | | |* [创建房间](/developer_guides/create_room) |\ | | | |* [语音合成](/developer_guides/text_to_speech) |\ | | | | |\ | | | |:::tip 说明 |\ | | | |体验智能语音功能之前，需要先[申请公测](https://bytedance.larkoffice.com/docx/FQJ9dvBE7oLzu3xtacJc6Cyjnof)。 |\ | | | |::: | | | | | | \ |[创建知识库文件](/developer_guides/create_knowledge_files) |2024年12月16日 |新增参数 |新增 source_file_id 参数，向图片知识库中上传文件。 | | | | | | \ |[创建文本知识库](/guides/create_knowledge)等知识库 API |2024年12月16日 |新增 API |新增知识库管理 API，包括创建知识库、查看知识库列表等。 |\ | | | | |\ | | | |* [创建文本知识库](/guides/create_knowledge) |\ | | | |* [查看知识库列表](/developer_guides/list_dataset) |\ | | | |* [修改知识库信息](/developer_guides/update_dataset) |\ | | | |* [删除知识库](/developer_guides/delete_dataset) |\ | | | |* [查看知识库文件上传进度](/developer_guides/get_dataset_progress) |\ | | | |* [更新知识库图片描述](/developer_guides/update_image_caption) |\ | | | |* [查看知识库图片列表](/developer_guides/get_images) | | | | | | \ |[执行对话流](/developer_guides/workflow_chat) |2024年12月11日 |新增 API |执行已发布的对话流。对话流是基于对话场景的特殊工作流，关于对话流的详细说明可参考[工作流与对话流](/guides/workflow_and_chatflow)。 | ## 2024年10月 {#03b2beac} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[执行工作流](/developer_guides/workflow_run) |2024年10月30日 |新增参数 |扣子专业版用户调用此接口时，支持通过 **is_async** 参数异步运行工作流，适用于工作流执行耗时较长，导致运行超时的情况。异步运行时，工作流整体超时时间限制由 3 分钟延长至 24 小时，LLM 节点由 3 分钟延长至 5 分钟。 | | | | | | \ |[查询工作流异步运行结果](/developer_guides/workflow_history) |2024年10月30日 |新增 API |调用接口[执行工作流](/developer_guides/workflow_run)时，如果选择异步执行工作流，响应信息中会返回 execute_id，开发者可以通过本接口查询指定事件的执行结果。 | | | | | | \ |涉及所有 API 接口 |2024年10月15日 |修改 PAT 有效期 |2024年10月16日开始，新创建的[个人访问密钥（PAT）](https://www.coze.cn/open/oauth/pats)，有效期最长可设置为 30天。在此之前已创建的个人访问密钥有效期不受影响。 | ## 2024年9月 {#dfcf584f} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[查看空间列表](/developer_guides/list_workspace) |2024年9月24日 |新增 API |此 API 用于查看当前账号加入的空间列表。 | | | | | | \ |[删除消息](/developer_guides/delete_message) |2024年9月2日 |新增 API |此 API 用于删除指定会话中的消息。 | | | | | | \ |[发起对话](/developer_guides/chat_v3) |2024年9月2日 |新增参数 |[发起对话](/developer_guides/chat_v3)接口增加请求参数 extra_params，通常用于特殊场景下指定一些必要参数供模型判断，例如指定经纬度，并询问智能体此位置的天气。 | | | | | | \ |[获取已发布智能体的配置（即将下线）](/developer_guides/get_metadata) |2024年9月2日 |新增参数 |[获取已发布智能体的配置（即将下线）](/developer_guides/get_metadata)接口增加返回参数 knowledge，查看智能体详细配置时可查看智能体绑定的知识库列表。 | | | | | | \ |* 消息相关 API：[创建消息](/developer_guides/create_message)、[查看消息列表](/developer_guides/list_message)、[查看消息详情](/developer_guides/retrieve_message)和[修改消息](/developer_guides/modify_message) |\ |* 文件相关 API：[上传文件](/developer_guides/upload_files)、[查看文件详情](/developer_guides/retrieve_files) |\ |* 会话相关 API：[创建会话](/developer_guides/create_conversation)、[查看会话信息](/developer_guides/retrieve_conversation) |\ |* 对话相关 API：[查看对话详情](/developer_guides/retrieve_chat)、[提交工具执行结果](/developer_guides/chat_submit_tool_outputs) |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月 {#7fd46c1e} | | | | | \ |**API** |**发布时间** |**变更类型** |**说明** | |---|---|---|---| | | | | | \ |[执行工作流（流式响应）](/developer_guides/workflow_stream_run) |2024年8月21日 |新增 API |此 API 用于执行包含流式节点的工作流，例如消息节点、结束节点等。接口响应方式为流式响应，开发者需要从流式事件中获取并拼接工作流的输出信息。 | | | | | | \ |[恢复运行工作流（流式响应）](/developer_guides/workflow_resume) |2024年8月21日 |新增 API |当执行到问答节点时，工作流会中断运行并发起询问，此时需要调用[恢复运行工作流（流式响应）](/developer_guides/workflow_resume)API 回复 Bot，并继续运行工作流。 | | | | | | \ |[创建智能体](/developer_guides/create_bot) |\ |[更新智能体](/developer_guides/update_bot) |\ |[发布智能体](/developer_guides/publish_bot) |2024年8月20日 |新增 API |发布智能体管理相关接口，开发者可通过 API 方式创建 Bot、更新 Bot、发布智能体为 API 服务。 | | | | | | \ |[执行工作流](/developer_guides/workflow_run) |2024年8月16日 |新增 API |此 API 用于执行一个已发布的工作流，接口响应方式为非流式响应。 | | | | | | \ |**[取消进行中的对话](/developer_guides/chat_cancel)** |2024年8月7日 |新增 API |调用[发起对话](/developer_guides/chat_v3)接口时，如果对话触发了复杂的工作流、图像流，或模型处理数据量大时，对话可能耗时较久。对话进行中时，用户无法在此会话中发起新的对话。此时可以调用此接口取消正在进行中的对话，取消后，对话转为已取消状态（status=canceled），你可以在会话中创建新的对话。 | ## {#425505b4}