메인 콘텐츠로 건너뛰기
POST
/
calls
/
usage
calls 사용량
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": {},
  "unfinished_call_ids": [
    "<string>"
  ]
}

인증

​
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의 집계된 사용량을 계산하기 위한 요청입니다.

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

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

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

집계할 루트 call ID입니다. 각 결과 키는 입력 call ID 하나에 해당합니다.

​
include_costs
boolean
기본값:false

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

​
limit
integer
기본값:10000

모든 트레이스에서 처리할 최대 call 수입니다. 무제한적인 메모리 사용을 방지하기 위한 안전 한도로 작동합니다.

응답

성공적인 응답

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

​
call_usage
Call Usage · object
​
unfinished_call_ids
string[]