Billing, SCU, And Limits

Citadel billing is based on SCU, short for Security Compute Units. SCU measures the amount of security compute used by a scan.

There is no public dollar rate. Starting October 1, 2026, Mighty will not offer direct purchase of the hosted SaaS plan. New commercial terms will be enterprise or custom, scoped on a call.

Text uses the least compute. Image and document work use more. Mode controls scan depth and latency. Focus controls the image evidence family and image-unit billing. One path is 4 SCU per image, two paths are 8 SCU per image unit, and all-evidence review (all three paths, or focus=all) bills 12 SCU per image unit (4 SCU × 3 paths).

For routing PDF scans, page work and embedded image work are separate. They are added together. A PDF page with embedded images costs more than scanning plain extracted text, and embedded images use the active focus image-unit price. focus=metadata uses parent and native image counts instead.

Mode And Focus Pricing

Counts stay physical. One image is one image unit. Two evidence paths bill 8 SCU per image unit; the full triple (focus=all) bills 12 SCU per image unit (4 SCU × 3 paths). Linear pricing does not turn the image count into a fractional value.

SCU By Modality

On routing scans, PDF embedded images are billed separately from page processing. They are deduplicated by hash before counting, so the same logo repeated on many pages should count once.

PDF SCU Formula

For routing PDFs, calculate focused scans like this:

Focused PDF SCU = pages * 2 + unique embedded images * 4

For all-evidence review:

All-evidence PDF SCU = pages * 2 + unique embedded images * 12

Examples:

For routing scans, document pages and embedded image count are separate usage metrics that add together.

For routing scans, count pages, then count unique embedded images, then add both charges. A one-page focused PDF with four unique embedded images is 18 SCU. The same PDF with focus=all is 50 SCU.

For focus=metadata, use 2 * metadata_parent_count + 2 * analyzed_native_image_count. The response exposes these counts in usage_units when nonzero. Rejected formats and failed admission cost 0 SCU. An ordinary routing scan's optional file_evidence and content_credentials receipts do not add SCU.

What The Response Can Include

{
  "action": "WARN",
  "risk_score": 68,
  "scan_id": "4e7c5fc1-6947-492b-bd22-0589d6477c8b",
  "scan_group_id": "9b3e4f8d-96c9-4f42-8338-8cf9571c1c70",
  "scu_charged": 12
}

Logs and dashboard usage can also show allowance remaining and whether usage was included or overage.

Allowance And Overage

The billing page shows:

• Included SCU for the current period.
• SCU used this period.
• Overage SCU when usage passes the included allowance.
• Organization spending limit.
• Estimated total.

If billing or tier policy blocks a scan, handle 402. If payload size or file complexity blocks a scan, handle 413. If rate limits block a scan, handle 429.

Limits

Current PDF tier ceilings:

These are per-request ceilings for PDFs. They are separate from rate limits, billing allowance, and organization spending limits.

What Developers Should Do

1. Show upload size and file type limits before upload.
2. Use async scans for high-value images and large PDFs.
3. Route 402 to billing, upgrade, or admin action.
4. Route 413 to reduce file size, split the PDF, or review manually.
5. Route 429 to retry with backoff.
6. Log scu_charged, scan_id, request_id, and scan_group_id.

Common Mistakes

• Thinking text and image scans cost the same. Image and document scans use more compute.
• Missing that two evidence paths bill 8 SCU per image unit, and that focus=all and deprecated focus=both bill 12 SCU per image unit.
• Treating 402 as a generic failure. It usually needs a billing or tier action.
• Treating 413 as only a file size issue. It can also represent a tier file cap.
• Retrying 429 immediately. Use backoff.
• Running comprehensive async review on every low-risk text message.

For plain-language definitions of mode, focus, AI edits, steganography, and prompt injection, see the glossary.

AI-Agent Prompt

Make this Citadel integration billing-aware and limit-aware.

Requirements:
- Log scu_charged when returned.
- Store scan_id, request_id, scan_group_id, session_id, action, and risk_score.
- Explain SCU in developer comments or admin UI as Security Compute Units.
- Handle 402 as billing, quota, tier cap, or spending limit action.
- Handle 413 as file size, PDF page cap, embedded image cap, or payload complexity.
- Handle 429 with retry backoff.
- Use async scans for high-value images and large PDFs.
- Do not run comprehensive mode on every low-risk text message.

Acceptance criteria:
- Tests cover successful scan with scu_charged.
- Tests cover 402, 413, and 429.
- Large file workflows can route to manual review or ask the user to split the file.
- Logs expose enough IDs for support and billing investigation.