全部產品
Search
文件中心

DataWorks:GetAgentSessionTokenUsage - 查詢會話Token用量

更新時間:May 06, 2026

按SessionId彙總查詢該會話累計的AIToken用量

介面說明

請求說明

  • 本介面用於擷取指定會話中各類 AI Token(包括 prompt、completion、thoughts)的使用量統計,同時提供總 token 數與快取命中 token 數。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

POST  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

Jsonrpc

string

JSON-RPC 版本,固定 2.0

2.0

Id

string

請求方傳入的 id,原樣回顯

1033814166

Params

object

業務參數

SessionId

string

會話 ID,必填

sess_0f12abc34

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

Id of the request

B313938A-4475-599B-98EB-A0875019FD5B

JsonRpcResponse

object

JSON-PRC 的返回結果

Jsonrpc

string

JSON-RPC 版本,固定 2.0

2.0

Id

string

請求方傳入的 id,原樣回顯

8212598228302533855

Result

object

Token 用量結果

PromptTokens

integer

Prompt 消耗 token 數累計

1000

CompletionTokens

integer

Completion 產生 token 數累計

2000

ThoughtsTokens

integer

思考過程 token 數累計

3000

TotalTokens

integer

總 token 數累計

2000

CachedTokens

integer

命中緩衝的 token 數累計

4000

樣本

正常返回樣本

JSON格式

{
  "RequestId": "B313938A-4475-599B-98EB-A0875019FD5B",
  "JsonRpcResponse": {
    "Jsonrpc": "2.0",
    "Id": "8212598228302533855",
    "Result": {
      "PromptTokens": 1000,
      "CompletionTokens": 2000,
      "ThoughtsTokens": 3000,
      "TotalTokens": 2000,
      "CachedTokens": 4000
    }
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情