pdf

Inspect a PDF and propose an extraction strategy (no job, no charge)

Upload a PDF and receive metadata, per-page stats, source classification, and an estimated cost. Use this to show users what they're about to spend before calling /v1/deck/from-pdf. No job is created and the file is not persisted — re-upload the same file to /v1/deck/from-pdf when ready.

post/v1/deck/from-pdf/analyze

Request

  • Base URL: https://api.slideforge.dev
  • URL: https://api.slideforge.dev/v1/deck/from-pdf/analyze
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Response

Analysis returned

producerstring

PDF metadata producer string (telemetry only — never used for routing). Captured so we can correlate buckets with real-world tools after the fact.

page_countinteger required

Number of pages in the PDF

file_size_bytesinteger required

Source PDF size in bytes

bucket'slide-vector' | 'slide-raster' | 'doc-text' | 'doc-image-heavy' | 'scanned' | 'mixed' | 'unknown' required

Routing decision derived from structural features. The /v1/deck/from-pdf endpoint accepts a file iff its bucket is currently implemented.

estimated_cost_usdnumber required

Per-page price for the bucket × page_count

can_extractboolean required

True iff /v1/deck/from-pdf will currently accept this file.

unsupported_reasonstring nullable

Human-readable hint shown to the user when can_extract is False, explaining what's not yet supported.

Changes

No recorded changes to this operation across all 1 revision of this API.