文档中心

火山方舟

会话事件

发送会话事件

POST https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}/events

向指定会话发送用户侧事件。

需要实时接收智能体输出和状态变化时，创建会话后先建立流式事件连接，再调用本接口发送事件。无需实时接收时，可在发送后通过获取会话事件列表查询结果。

接口成功响应仅表示事件已受理，不表示本轮处理完成。事件字段结构请参见会话事件结构参考。

说明

user.message 事件的 content 数组支持文本、图片、文档、视频等多种内容块。图片、文档和视频块均可将 source.type 设为 file，并通过 source.file_id 引用 Files API 已上传的文件。purpose 为 user_data 或 agent 的文件均可复用。文件能否直接传入当前模型，由模型能力和内容类型共同决定；不满足条件时，可通过会话 resources 将文件挂载到会话运行环境中处理。字段结构详情请参见会话事件结构参考。

鉴权

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

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

请求参数

Path 参数

session_id string 必选 | 会话 ID

Body 参数

events object[] 必选 | 事件列表

响应参数

data object[] | 已接收事件列表

发送会话事件

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

Request

curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/sessions/<SESSION_ID>/events" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "events": [
    {
      "type": "user.message",
      "content": [{"type": "text", "text": "帮我梳理 Q3 目标，并列出交付判据"}]
    }
  ]
}
EOF

Response

{
  "data": [
    {
      "id": "sevt-20260926143025-a1b2c",
      "type": "user.message",
      "content": [
        {"type": "text", "text": "帮我梳理 Q3 目标，并列出交付判据"}
      ]
    }
  ]
}

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

这个页面对您有帮助吗？

有用

无用