すべてのプロダクト
Search
ドキュメントセンター

DataWorks:GetAgentSessionTokenUsage

最終更新日:May 06, 2026

指定されたセッションの AI トークン使用量を累計で取得します。

操作説明

概要

  • この操作は、指定されたセッションにおける AI トークンの使用状況を取得します。プロンプト、コンプリーション、思考(thoughts)ごとのトークン数の内訳、合計トークン数、およびキャッシュヒットしたトークン数を提供します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

Jsonrpc

string

任意

JSON-RPC のバージョンです。値は常に 2.0 です。

2.0

Id

string

任意

リクエスト側が指定した ID で、応答にそのまま返されます。

1033814166

Params

object

任意

ビジネスパラメーターです。

SessionId

string

任意

セッション ID です。必須項目です。

sess_0f12abc34

レスポンスフィールド

フィールド

説明

object

応答スキーマ

RequestId

string

リクエスト ID です。

B313938A-4475-599B-98EB-A0875019FD5B

JsonRpcResponse

object

JSON-RPC の結果です。

Jsonrpc

string

JSON-RPC のバージョンです。値は常に 2.0 です。

2.0

Id

string

リクエスト側が指定した ID で、応答にそのまま返されます。

8212598228302533855

Result

object

トークン使用量の結果です。

PromptTokens

integer

消費されたプロンプトトークンの累計数です。

1000

CompletionTokens

integer

生成されたコンプリーショントークンの累計数です。

2000

ThoughtsTokens

integer

思考処理に使用されたトークンの累計数です。

3000

TotalTokens

integer

すべてのトークンの累計数です。

2000

CachedTokens

integer

キャッシュヒットしたトークンの累計数です。

4000

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。