pdf

Ingest: inspect a PDF, no job, no charge

Free preview endpoint — no charge, no persistence.

Logs each call's producer + page count + source classification to slideforge.telemetry so we can see what real users upload and prioritize which producers to support next. Fire-and-forget — never fails the request.

post/v1/render/from-pdf/analyze

Request

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

Response

Successful Response

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.