Passer au contenu principal
POST
/
calls
/
stats
Statistiques des appels
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": []
}

Autorisations

​
Authorization
string
header
requis

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

Corps

application/json

Requête pour obtenir des statistiques d’appels agrégées sur une plage temporelle.

​
project_id
string
requis
​
start
string<date-time>
requis

Heure de début inclusive (UTC, ISO 8601).

​
end
string<date-time> | null

Heure de fin exclusive (UTC, ISO 8601). Utilise l’heure actuelle par défaut si elle est omise.

​
granularity
integer | null

Taille du bucket en secondes (par ex., 3600 pour 1 heure). Si elle est omise, elle est sélectionnée automatiquement en fonction de la plage temporelle. Elle sera ajustée si elle devait produire plus de 10 000 buckets.

​
usage_metrics
UsageMetricSpec · object[] | null

Métriques d’utilisation (tokens, coût) à calculer. Regroupées par horodatage et par modèle.

​
call_metrics
CallMetricSpec · object[] | null

Métriques au niveau des appels (latence, décomptes) à calculer. Regroupées uniquement par horodatage.

​
filter
CallsFilter · object
​
timezone
string
défaut:UTC

Fuseau horaire IANA pour l’alignement des buckets (par ex., 'America/New_York')

Réponse

Réponse réussie

Réponse contenant des statistiques d’appels sous forme de série temporelle.

​
start
string<date-time>
requis

Heure de début résolue (UTC)

​
end
string<date-time>
requis

Heure de fin résolue (UTC)

​
granularity
integer
requis

Taille du bucket utilisée (en secondes)

​
timezone
string
requis

Fuseau horaire utilisé pour l’alignement des buckets

​
usage_buckets
Usage Buckets · object[]

Métriques d’utilisation par modèle. Chaque bucket contient 'timestamp', 'model' et des valeurs de métriques agrégées.

​
call_buckets
Call Buckets · object[]

Métriques au niveau des appels. Chaque bucket contient 'timestamp' et des valeurs de métriques agrégées.