メインコンテンツへスキップ
POST
/
calls
/
stats
call統計
curl --request POST \
  --url https://api.example.com/calls/stats \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "granularity": 123,
  "usage_metrics": [
    {
      "metric": "input_tokens",
      "aggregations": [
        "sum"
      ],
      "percentiles": []
    }
  ],
  "call_metrics": [
    {
      "metric": "latency_ms",
      "aggregations": [
        "sum"
      ],
      "percentiles": []
    }
  ],
  "filter": {
    "op_names": [
      "<string>"
    ],
    "input_refs": [
      "<string>"
    ],
    "output_refs": [
      "<string>"
    ],
    "parent_ids": [
      "<string>"
    ],
    "trace_ids": [
      "<string>"
    ],
    "call_ids": [
      "<string>"
    ],
    "thread_ids": [
      "<string>"
    ],
    "turn_ids": [
      "<string>"
    ],
    "trace_roots_only": true,
    "wb_user_ids": [
      "<string>"
    ],
    "wb_run_ids": [
      "<string>"
    ]
  },
  "timezone": "UTC"
}
'
{
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "granularity": 123,
  "timezone": "<string>",
  "usage_buckets": [],
  "call_buckets": []
}

承認

​
Authorization
string
header
必須

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

ボディ

application/json

一定期間における集計済みcall統計のリクエスト。

​
project_id
string
必須
​
start
string<date-time>
必須

開始時刻（この時刻を含む）（UTC、ISO 8601）。

​
end
string<date-time> | null

終了時刻（この時刻は含まない）（UTC、ISO 8601）。省略した場合は現在時刻がデフォルトです。

​
granularity
integer | null

bucketサイズ（秒単位）（例: 1時間の場合は3600）。省略した場合は、期間に基づいて自動的に選択されます。10,000個を超えるbucketが生成される場合は調整されます。

​
usage_metrics
UsageMetricSpec · object[] | null

計算するUsageメトリクス（トークン、コスト）。Timestampとモデルごとにグループ化されます。

​
call_metrics
CallMetricSpec · object[] | null

計算するcallレベルのメトリクス（レイテンシ、件数）。Timestampごとにのみグループ化されます。

​
filter
CallsFilter · object
​
timezone
string
デフォルト:UTC

bucketの整列に使用するIANAタイムゾーン（例: 'America/New_York'）

レスポンス

正常なレスポンス

時系列のcall統計を含むレスポンス。

​
start
string<date-time>
必須

解決後の開始時刻（UTC）

​
end
string<date-time>
必須

解決後の終了時刻（UTC）

​
granularity
integer
必須

使用されたbucketサイズ（秒単位）

​
timezone
string
必須

bucketの整列に使用されたタイムゾーン

​
usage_buckets
Usage Buckets · object[]

モデルごとのUsageメトリクス。各bucketには 'timestamp'、'model'、および集計済みメトリクス値が含まれます。

​
call_buckets
Call Buckets · object[]

callレベルのメトリクス。各bucketには 'timestamp' と集計済みメトリクス値が含まれます。