ドキュメント本文へスキップ
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 になる。

リファレンス