LintPDF LintPDF

AI overview

Enable, configure, and submit with AI-powered preflight inspections.

AI overview

AI-powered preflight inspections run on top of the detection engine — barcode decoding, spell check, brand compliance, regulatory labelling, image quality. This page is the full “turn it on and use it” walkthrough. If you want to go deeper, see Presets, Credits, Brand config, or the AI API reference.

Getting started — four steps

  1. Request access. AI is invite-only alpha on all paid plans. Email sales@lintpdf.com with your account ID and a one-line use case.
  2. Purchase credits. Pay-per-use ($0.12/credit) or volume packages starting at 100 credits for $10. Set up under Settings → AI Billing in the dashboard.
  3. Configure categories. Enable the categories you want under Settings → AI Inspections. Choose from barcode, content quality, color compliance, regulatory (FDA / EU / GHS / Pharma), brand, and visual quality.
  4. Submit with AI. Add ai_preset or ai_categories to your submit request.

Quick example

# Submit a PDF with the FDA food preset
curl -X POST https://api.lintpdf.com/api/v1/jobs \
  -H "Authorization: Bearer lpdf_your_api_key" \
  -F file=@food-label.pdf \
  -F profile_id=lintpdf-default \
  -F ai_preset=fda-food

# Check your credit balance
curl https://api.lintpdf.com/api/v1/ai/credits \
  -H "Authorization: Bearer lpdf_your_api_key"

Prerequisites

  • Active account on a paid plan (Starter, Growth, Scale, or Enterprise).
  • AI features enabled for your account (request via sales@lintpdf.com).
  • A valid API key with AI scope.

Once AI is enabled, the dashboard surfaces an AI Inspections section under Settings.

AI categories

CategoryInspectionsTierWhat it covers
barcode7TextType detection, decode, quiet zones, contrast, placement
content_quality3TextSpell check, language detection, duplicates
color_compliance2TextBrand palette validation, contrast ratio
regulatory_fda5VisionFDA Nutrition Facts (21 CFR 101.9)
regulatory_eu4VisionEU Food Information (Reg. 1169/2011)
regulatory_ghs5VisionGHS/CLP chemical labels (Reg. 1272/2008)
regulatory_pharma3VisionEU FMD serialization, Braille, font
brand2MixedLogo matching, palette compliance
visual_quality2VisionImage quality, NSFW screening

Enable categories under Settings → AI Inspections; they apply to every submission unless you override them per-request.

Configuration levels

AI settings resolve at three levels, from broadest to most specific:

  1. Account defaults — Your standing category selection under Settings.
  2. Ruleset settings — A ruleset can bake in its own ai_categories; see the Presets doc for the named bundles.
  3. Per-request — ai_preset=<name> or ai_categories=barcode,content_quality,regulatory_fda on the submit payload override both of the above for that single job.

Brand configuration

Brand-related inspections read three kinds of assets from Settings → AI Brand:

  • Color palette — approved brand colors as hex values with Delta E tolerance.
  • Reference logos — upload variations (horizontal, stacked, icon-only, reversed).
  • Custom dictionary — brand names, product names, and technical terms that the spell checker should treat as valid.

More under AI Brand config.

Confidence threshold

Set the minimum confidence score for AI findings under Settings → AI Inspections. Default is 0.75. Findings below the threshold are still computed but hidden from the report unless you query the ?include_low_confidence=true variant.

Billing modes

Choose your billing mode under Settings → AI Billing:

  • Pay-per-use — credits consumed at $0.12 each, no minimum. Optional auto top-up when balance runs low.
  • Credit package — buy a block at volume discount. Starter (100) / Growth (500) / Scale (2,000) / Enterprise (10,000).

See Credits for the full billing model and Monitoring for usage analytics.

Verification

After submitting with AI enabled, the report’s findings include entries with source: "ai" alongside core engine findings. Check balance via the dashboard (Settings → AI Billing) or the API:

curl https://api.lintpdf.com/api/v1/ai/credits \
  -H "Authorization: Bearer lpdf_..."

Submit with category override

Want a specific category cocktail instead of a named preset? Pass ai_categories explicitly:

curl -X POST https://api.lintpdf.com/api/v1/jobs \
  -H "Authorization: Bearer lpdf_..." \
  -F file=@packaging.pdf \
  -F profile_id=lintpdf-default \
  -F ai_categories=barcode,content_quality,regulatory_fda