发送流式消息概述
即时通讯服务提供流式消息服务,支持在单聊和群聊中发送流式消息。该功能特别适用于大模型流式响应场景,例如 AI 生成文本、实时翻译或动态内容推送等场景,确保消息能够分块传输并逐段展示,减少延迟,增强互动性。此外,流式消息服务还支持消息的唯一标识(messageUID
),便于客户端对消息进行跟踪和管理,确保消息的完整性和连续性。客户端 SDK 从 5.16.0 版本开始全面支持该功能,能够以打字机效果实时展示消息内容,显著提升用户体验。
发流限制
- 同一流发送中断间隔最大 30秒。超过30秒后服务自动判断为流已中断,不在接收后续发送的流数据,拉到的流 stopReason 为 29003。
- 在持续发流超时情况下最长 支持 30min, 超过30分钟后自动阶段并丢弃30min 后的流数据,拉到的流 stopReason 为 29004。
交互时序图
服务能力及相关 API 接口
名称 | 接口 |
---|---|
单聊发送流式消息 | /v3/message/private/publish_stream.json 接口用于 1v1 单聊场景下发送流式消息 |
群聊发送流式消息 | /v3/message/group/publish_stream.json 接口用于群聊场景下发送流式消息 |
服务端获取流内容 | /v3/message/get_stream.json 接口用于 App Server 查看消息流内容 。 |