메인 콘텐츠로 건너뛰기
POST
/
calls
/
usage
콜 사용량
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
}
'
{
  "call_usage": {}
}

인증

​
Authorization
string
header
필수

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

본문

application/json

여러 루트 호출(root call)에 대한 집계 사용량을 계산하기 위한 요청입니다.

이 엔드포인트는 요청된 각 루트 호출에 대한 사용 메트릭을 반환하며, 각 루트의 메트릭에는 해당 루트 자체의 사용량과 모든 하위(자손) 호출의 사용량 합계가 포함됩니다.

참고: 집계를 위해 일치하는 모든 호출이 메모리로 로드됩니다. 결과 집합이 매우 큰 경우(>10k calls), 루트 호출 ID를 배치로 나누거나 애플리케이션 레이어에서 더 좁은 필터를 사용하는 것을 고려하십시오.

​
project_id
string
필수
​
call_ids
string[]
필수

집계할 루트 호출 ID입니다. 각 결과 키는 하나의 입력 호출 ID에 대응합니다.

​
include_costs
boolean
기본값:false

true이면 사용량에 비용 계산을 포함합니다.

​
limit
integer
기본값:10000

전체 트레이스에서 처리할 최대 호출 수입니다. 무제한 메모리 사용을 방지하기 위한 안전 상한으로 동작합니다.

응답

성공 응답

루트 호출별 집계 사용 메트릭이 포함된 응답입니다.

​
call_usage
Call Usage · object