Skip to content

Meter Kinds

Meter Kinds

Every sign operation increments one billing meter. Meters are recorded in the audit log and reported in GET /v1/usage. The billing.meter field in a recipe specifies which meter to use.

Meter reference

MeterDescriptionPlans
image_signSign one image (JPEG, PNG, WebP)All
audio_signSign one audio file (WAV, MP3, FLAC, OGG)Developer+
video_signSign one video file (MP4, WebM)Developer+
text_signSign one text generation event (SynthID-Text hook)Developer+
image_verifyVerify one image (authenticated, counted)All
audio_verifyVerify one audio fileDeveloper+
video_verifyVerify one video fileDeveloper+
lookupOne soft-binding lookup callAll
byok_signSign using BYOK KMS key (additional meter on top of modality meter)Enterprise BYOK
anchor_batchOne anchor batch submission (all batch members share one submission credit)Growth+

Notes

  • image_verify, audio_verify, video_verify: public verify (POST /v1/verify without authentication) does not count toward metered usage. Only authenticated verify calls are metered.
  • byok_sign is charged in addition to the base image_sign/audio_sign/video_sign meter. Both meters increment for a BYOK sign call.
  • anchor_batch: a batch may contain hundreds of manifest digests. Each batch counts as one submission, regardless of how many manifests it contains.
  • Verify calls that return an error due to an internal failure (verbitas.internal_error) are not metered.
  • Lookup calls that return zero matches are still metered.

Plan quotas

MeterFreeDeveloperGrowthEnterprise
image_sign50/mo1,000/mo20,000/moCustom
audio_sign500/mo10,000/moCustom
video_sign200/mo5,000/moCustom
image_verify (authenticated)100/mo5,000/mo50,000/moCustom
lookup100/mo5,000/mo50,000/moCustom

Exceeding a quota returns 402 verbitas.billing.quota_exceeded. On the Growth and Enterprise plans, usage above the included quota is charged per-unit at rates listed in your plan agreement.

Checking current usage

Terminal window
curl -H "Authorization: Bearer $VERBITAS_API_KEY" \
https://api.verbitas.io/v1/usage | jq .

Response:

{
"period_start": "2026-05-01T00:00:00Z",
"period_end": "2026-06-01T00:00:00Z",
"meters": {
"image_sign": { "used": 423, "limit": 1000 },
"image_verify": { "used": 101, "limit": 5000 },
"lookup": { "used": 55, "limit": 5000 }
}
}

Usage in the audit log

Every metered event is recorded in the audit log as asset.signed, asset.verified, or asset.lookup. The billing.meter field is included in the event data. Export the audit log to your billing system for cost allocation:

Terminal window
curl "https://api.verbitas.io/v1/audit?event_type=asset.signed&format=ndjson" \
-H "Authorization: Bearer $VERBITAS_API_KEY"