문서로 건너뛰기
API

사용량 내역 읽기

하루별 발송량과 AI 작업, 월별 사용량 기반 요금 초과분의 비용.

GET/billing/usage

워크스페이스에 실제 호출을 실행합니다.

GET /billing/usage

하루별 발송량과 AI 작업, 월별 사용량 기반 요금 초과분의 비용.

예시

billing:read가 필요합니다. days는 1일에서 3,660일 전까지 거슬러 올라가며 기본값은 30이고, all은 워크스페이스가 만들어진 날까지 거슬러 올라갑니다. aiExtra는 일일 허용량을 넘어 사용량 기반 요금으로 청구된 AI 작업을 셉니다.

curl
curl "$OE/billing/usage?days=7" -H "$AUTH"
응답
{  "object": "usage_history",  "days": [    { "day": "2026-10-02", "aiActions": 14, "aiExtra": 0, "sends": 2210 },    { "day": "2026-10-03", "aiActions": 9, "aiExtra": 0, "sends": 1870 }  ],  "months": [    {      "month": "2026-09",      "extraSends": 3000,      "extraAiActions": 0,      "sendCents": 120,      "aiCents": 0,      "cents": 120    }  ],  "dailyAiActions": 150,  "monthlySends": 200000}

결제에는 워크스페이스 소유자만 닿습니다: API 키, 또는 소유자가 모든 주소로 연결한 액세스 토큰입니다. 멤버의 토큰은 403 owner_only, 특정 주소나 도메인으로 제한된 키나 토큰은 422 capability_unsupported입니다.

레퍼런스