문서로 건너뛰기
API

사용량 기반 요금 읽기

허용량을 넘는 사용량이 청구되는지와 지금까지의 비용.

GET/billing/pay-as-you-go

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

GET /billing/pay-as-you-go

허용량을 넘는 사용량이 청구되는지와 지금까지의 비용.

예시

billing:read가 필요합니다. 금액은 미국 센트 단위입니다. limits는 고를 수 있는 월 한도, prices는 초과분의 가격, period는 사용량 기반 요금의 현재 청구 기간이며, 설정되기 전에는 null입니다.

curl
curl "$OE/billing/pay-as-you-go" -H "$AUTH"
응답
{  "object": "pay_as_you_go",  "available": true,  "enabled": true,  "suspended": false,  "enrolled": true,  "switchedOn": true,  "coversSends": true,  "coversAiActions": true,  "limitCents": 5000,  "spentCents": 120,  "extraSends": 3000,  "extraAiActions": 0,  "estimatedCents": 120,  "limits": [1000, 2500, 5000, 10000, 25000, 50000, 100000, 250000, 500000],  "prices": {    "sends": { "unit": 1000, "priceCents": 40 },    "aiActions": { "unit": 100, "priceCents": 25 }  },  "period": {    "endsAt": "2026-11-01T09:00:00.000Z",    "sends": 3000,    "aiActions": 0,    "estimatedCents": 120  }}

enabled는 초과분이 청구되는 동안 true입니다: 켜져 있고 일시 중지되지 않은 상태. suspended는 마지막 결제가 실패했다는 뜻이며, 카드는 결제 포털에서 업데이트합니다.

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

레퍼런스