You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
会话任务
查询会话任务列表
复制全文
下载 pdf
查询会话任务列表
GET https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}/tasks​
分页查询指定会话中的后台工具任务,可按任务状态或会话线程筛选。​
列表只返回任务摘要,不返回执行结果 result。如需读取任务结果、日志位置或产物路径,请使用 查询会话任务 。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • API Key 鉴权,请在 API Key 管理 页面,获取长效 API Key。​
​​
请求参数​
Path 参数​
session_id string 必选 | 会话 ID​
​
​
Query 参数​
在 URL Query String 中传入。​
cursor integer | 下一页标识​
​
limit integer 默认值 20 | 每页任务数​
​
session_thread_id string | 会话线程 ID​
​
state string | 任务状态​
​
​
响应参数​
items object[] | 任务列表​
​
next_cursor integer | 下一页标识​
​
​

Request

curl -sS --fail-with-body \
  "https://ark.cn-beijing.volces.com/api/v3/sessions/${SESSION_ID}/tasks?session_thread_id=${SESSION_THREAD_ID}&state=queued,running&limit=20" \
  -H "Authorization: Bearer $ARK_API_KEY"

Response

{
  "items": [
    {
      "task_id": "task-20260910173330-54321",
      "tool": {
        "name": "video_generate",
        "tool_use_id": "toolu_02",
        "description": "Generate a city night video"
      },
      "session_id": "<SESSION_ID>",
      "session_thread_id": "sthr-20260910171500-abcde",
      "state": "running",
      "summary": "生成一段城市夜景视频",
      "created_at": 1789032810494,
      "started_at": 1789032813926
    }
  ],
  "next_cursor": 1024
}
最近更新时间:2026.10.28 19:53:33
这个页面对您有帮助吗?
有用
有用
无用
无用