流式接收会话线程事件

通过 OMA API 流式接收会话线程事件。

GET /v1/sessions/{session_id}/threads/{thread_id}/stream

流式接收会话线程事件

cURL

curl --request GET \
  --url http://localhost:38080/v1/sessions/{session_id}/threads/{thread_id}/stream \
  --header 'X-Api-Key: <api-key>'

200

{
  "type": "user.message",
  "id": "sevt_011CZkZGOp0iBcp4kaQSihUmy",
  "content": [
    {
      "type": "text",
      "text": "我的订单 #1234 到哪里了？"
    }
  ],
  "processed_at": "2026-03-15T10:00:00Z"
}

每个请求都必须发送 ?beta=true。

响应使用 text/event-stream。连接断开后应重新连接；在最终事件到达前，事件增量只应视为尽力而为的预览。

授权

omaApiKeyomaBearer

X-Api-Key · string · header · 默认值: sk-ant-local-default · 必填

OMA 工作区 API 密钥。

请求头

anthropic-version · string

anthropic-beta · string

路径参数

session_id · string · 必填

会话标识符。

thread_id · string · 必填

会话线程标识符。

查询参数

beta · enum<boolean> · 必填

为此接口启用 Beta API 合同，必须为 true。

可用选项: true

event_deltas[] · enum<string>[]

设置后，该连接还会在事件生成过程中、事件本身到达之前接收流式增量（event_start、event_delta）。增量是尽力而为的；最终事件生成时会携带完整内容。提前结束的模型请求（出错或被中断）不会产生最终事件——其终止 span.model_request_end 会关闭预览。接受一个或多个要预览的事件类型，并且可以重复指定：agent.message 流式传输 content_delta 片段；agent.thinking 仅有开始信号——表示智能体已开始扩展思考，由 agent.thinking 事件本身收尾。只发送所请求事件类型的预览。

EventDeltaType 枚举

可用选项: agent.message, agent.thinking

响应

200

application/json

请求成功。

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Option 36

Option 37

会话对话中的用户消息事件。

type · enum<string> · 必填

可用选项: user.message

示例:

"user.message"

id · string · 必填

此事件的唯一标识符。

示例:

"sevt_011CZkZGOp0iBcp4kaQSihUmy"

content · object[] · 必填

构成用户消息的内容块数组。

普通文本内容。

Option 1

Option 2

Option 3

Option 4

Show child attributes

示例:

{
  "type": "text",
  "text": "我的订单 #1234 到哪里了？"
}

示例:

[
  {
    "type": "text",
    "text": "我的订单 #1234 到哪里了？"
  }
]

processed_at · string<date-time> | null

智能体完成处理此消息的时间戳。

示例:

"2026-03-15T10:00:00Z"