Utilisation des appels

Calcule l’utilisation agrégée pour plusieurs appels racine, avec agrégation des descendants.

POST /calls/usage

Utilisation des appels

cURL

curl --request POST \
  --url https://api.example.com/calls/usage \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "call_ids": [
    "<string>"
  ],
  "include_costs": false,
  "limit": 10000
}
'

200

{
  "call_usage": {},
  "unfinished_call_ids": [
    "<string>"
  ]
}

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 calculer l’utilisation agrégée de plusieurs appels racine.

Cet endpoint renvoie les métriques d’utilisation pour chaque appel racine demandé, où les métriques de chaque racine incluent la somme de sa propre utilisation et de celle de tous ses descendants.

Remarque : tous les appels correspondants sont chargés en mémoire pour l’agrégation. Pour des ensembles de résultats très volumineux (>10k appels), envisagez de traiter les ID des appels racine par lots ou d’utiliser des filtres plus restrictifs au niveau de l’application.

project_id · string · requis

call_ids · string[] · requis

ID des appels racine à agréger. Chaque clé de résultat correspond à un ID d’appel en entrée.

include_costs · boolean · défaut: false

Si la valeur est true, inclure les calculs de coût dans l’utilisation.

limit · integer · défaut: 10000

Nombre maximal d’appels à traiter sur l’ensemble des traces. Sert de limite de sécurité pour éviter une utilisation de mémoire non bornée.

Réponse

200

application/json

Réponse réussie

Réponse contenant les métriques d’utilisation agrégées par appel racine.

call_usage · Call Usage · object

Show child attributes

unfinished_call_ids · string[]