사용량 가져오기

조직의 추정 번역 토큰 사용량과 테이블별 데이터베이스 바이트 사용량을 보고합니다.

WorkOS 조직의 언어별 추정 번역 토큰 사용량과 테이블별 데이터베이스 바이트 사용량을 보고합니다.

인증: Bearer JWT(WorkOS).

쿼리 매개변수

매개변수	유형	필수	비고
`orgId`	uuid	예	보고할 WorkOS 조직입니다.

응답

{
  "orgId": "...",
  "translations": {
    "translations": 120,
    "estimatedPromptTokens": 45000,
    "estimatedCompletionTokens": 42000,
    "estimatedTotalTokens": 87000,
    "byLanguage": [
      {
        "language": "fr",
        "translations": 40,
        "estimated_prompt_tokens": 15000,
        "estimated_completion_tokens": 14000,
        "estimated_total_tokens": 29000
      }
    ],
    "note": "..."
  },
  "database": {
    "totalBytes": 1048576,
    "totalHuman": "1.0 MB",
    "byTable": [ { "table": "documents", "rows": 42, "bytes": 500000 } ],
    "note": "..."
  }
}

토큰 수는 (~토큰당 약 4자 기준과 호출당 고정 시스템 프롬프트 허용량을 합산한) 추정치이며, 제공업체가 청구하는 사용량이 아닙니다.

데이터베이스 사용량은 소유한 각 테이블의 pg_column_size 값을 합산하며, 오브젝트 스토리지에 저장된 이미지 바이너리는 포함되지 않습니다.

byLanguage 내부에서는 토큰 키가 스네이크 표기(estimated_prompt_tokens 등)인 반면, 부모 객체는 카멜 표기를 사용한다는 serde 관련 특성을 유의하세요.

예시

curl '{CMS_API_URL}/usage?orgId=<uuid>' \
  -H 'Authorization: Bearer <workos-jwt>'

오류

400 — orgId 가 누락되었거나 잘못되었습니다
401 — JWT가 누락되었거나 잘못되었습니다
500 — 쿼리에 실패했습니다

Previous‹번역 패치 NextPOST /csv›