文档中心

火山方舟

会话线程

查询线程详情

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

查询指定线程的当前状态、关联智能体和主子关系。已知 thread_id 时使用本接口。

查看全部线程请使用查询线程列表；排查执行过程请使用获取线程事件列表。

说明

支持动态 Subagent 的会话会返回平台记录的线程信息。历史会话没有单独的线程记录，接口会根据已有事件还原出线程列表和状态。

鉴权

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

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

请求参数

Path 参数

session_id string 必选 | 会话 ID

thread_id string 必选 | 线程 ID

响应参数

agent_name string | 智能体名称

created_at string | 创建时间

id string | 线程 ID

parent_thread_id string / null | 父线程 ID

session_id string | 会话 ID

status string | 线程状态

type string | 对象类型

updated_at string | 更新时间

stats object | 线程时长统计

usage object | 线程用量

查询会话线程详情

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

Request

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

Response

{
  "id": "<THREAD_ID>",
  "session_id": "<SESSION_ID>",
  "status": "idle",
  "agent_name": "<AGENT_NAME>",
  "parent_thread_id": null,
  "stats": {
    "active_seconds": 68.206,
    "duration_seconds": 125.431,
    "startup_seconds": 2.75
  },
  "usage": {
    "active_seconds": 68.206,
    "cache_creation": {
      "ephemeral_1h_input_tokens": 0,
      "ephemeral_5m_input_tokens": 0
    },
    "cache_read_input_tokens": 126210,
    "input_tokens": 22,
    "output_tokens": 2373,
    "server_tool_use": {
      "web_fetch_requests": 0,
      "web_search_requests": 2,
      "general_search_requests": 1,
      "visual_search_requests": 0
    }
  },
  "created_at": "2026-07-15T08:30:14.900Z",
  "updated_at": "2026-07-15T08:30:19.220Z",
  "type": "session_thread"
}

最近更新时间：2026.11.04 18:12:41

这个页面对您有帮助吗？

有用

无用