文档中心

火山方舟

会话线程

流式获取线程事件

GET https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}/threads/{thread_id}/stream

通过 SSE（Server-Sent Events）协议订阅指定线程视角的实时事件。订阅主线程时，可能同时收到子线程的创建、状态变化和需要主线程处理的工具请求通知。所有事件的结构定义详情请参见会话事件结构参考。

说明

本接口不支持断线续传。连接中断后，可通过获取线程事件列表查询中断期间产生的事件，再重新建立流式连接。

连接建立后先收到 : ready，随后约每 15 秒收到 : heartbeat。服务实例退出前可能发送 : server draining, reconnect，收到后应重新连接。客户端应忽略这些 SSE 注释行，并将读取超时设置为至少两个心跳周期。

服务端通过 data: 行发送事件 JSON，可以省略显式 event: 行。线程进入 idle 不会自动关闭连接；客户端不再监听时需要主动断开。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Path 参数

session_id string 必选 | 会话 ID

thread_id string 必选 | 线程 ID

Query 参数

在 URL Query String 中传入。

event_deltas array | 流式预览事件类型

响应参数

SSE 流式响应，每个事件为一个 SessionEvent 对象，仅包含当前线程相关事件

data string | 事件 JSON 数据

event string | SSE 事件类型

流式获取线程事件

发起调试等同于请求真实调用，可能产生云产品费用，请谨慎操作！

Request

curl -sS --fail-with-body -N \
  "https://ark.cn-beijing.volces.com/api/v3/sessions/<SESSION_ID>/threads/<THREAD_ID>/stream" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Accept: text/event-stream"

Response

: ready

data: {"id":"sevt-20260715083015-a1b2c","type":"session.status_running","processed_at":"2026-07-15T08:30:15.123Z"}

data: {"id":"sevt-20260715083015-b2c3d","type":"user.message","processed_at":"2026-07-15T08:30:15.130Z","content":[{"type":"text","text":"帮我梳理 Q3 目标"}]}

data: {"id":"sevt-20260715083017-c3d4e","type":"agent.message","processed_at":"2026-07-15T08:30:17.045Z","session_thread_id":"<THREAD_ID>","content":[{"type":"text","text":"好的，我先按 OKR 分层梳理。"}]}

data: {"id":"sevt-20260715083017-d4e5f","type":"session.thread_status_idle","processed_at":"2026-07-15T08:30:17.100Z","session_thread_id":"<THREAD_ID>","agent_name":"demo-agent","stop_reason":{"type":"end_turn"}}

data: {"id":"sevt-20260715083017-e5f6g","type":"session.status_idle","processed_at":"2026-07-15T08:30:17.101Z","stop_reason":{"type":"end_turn"}}

: heartbeat

最近更新时间：2026.10.28 19:53:17

这个页面对您有帮助吗？

有用

无用