[tomasr78]

Problem

The example cut page 1 out of the PDF with the extract converter and PageRange 1, then converted that page to JPG. pdf -> extract is now the AI data-extraction converter: it returns JSON and has no PageRange parameter (spec), so the second step gets a JSON file instead of page 1.

On main it fails:

$ python create_pdf_thumbnail.py        # examples/ on main d653b60, production API, 2026-11-06
Traceback (most recent call last):
  ...
requests.exceptions.HTTPError: 400 Client Error: Bad Request for url: https://v2.convertapi.com/convert/json/to/jpg
  ...
convertapi.exceptions.ApiError: Parameter validation error. Code: 4000. {'SourceFormat, DestinationFormat': ['Unsupported conversion json -> jpg']}

Change

• One pdf -> jpg call with PageRange 1 makes the thumbnail: one conversion instead of two.
• ScaleImage and ScaleProportions are dropped. They are not pdf -> jpg parameters (spec) and the API ignores them: with or without them, ImageHeight 300 + ImageWidth 300 returns a 300x388 image for test.pdf (US Letter), byte for byte the same. FitToSize keeps the thumbnail inside 300x300 with its aspect ratio: 231x300.
• The comment links only https://www.convertapi.com/pdf-to-jpg.

Verification

Run from examples/ against the production API on 2026-11-06, Python 3.14.7, with the SDK installed from this branch ($TMPDIR is the local temp folder):

$ python create_pdf_thumbnail.py
The thumbnail saved to ['$TMPDIR/test.jpg']

test.jpg is 231x300 px, 8,858 bytes.

Only the example changes, not the library, so there is no CHANGELOG entry.

The thumbnail examples of the other SDKs are fixed in ConvertAPI/convertapi-library-php#72, ConvertAPI/convertapi-library-ruby#42, ConvertAPI/convertapi-library-java#56, ConvertAPI/convertapi-library-dotnet#82, ConvertAPI/convertapi-library-node#123.

🤖 Generated with Claude Code

[Copilot]

🟢 Approval recommended

No active review issues are recorded for the PDF thumbnail example update.

No open issues 🎉

What changed in this PR

Fixes the PDF thumbnail example by converting the first PDF page directly to JPG, avoiding the extraction converter’s JSON output.

Changes:

• Replaces the two-step conversion with one PDF-to-JPG call using PageRange: 1.
• Replaces unsupported scaling options with FitToSize to preserve aspect ratio within 300×300 pixels.
• Updates the explanatory comment and removes the extraction documentation link.

File	Description
examples/​create_pdf_thumbnail.py	Converts page 1 directly to a size-constrained JPG thumbnail and updates the comments.

_{Review effort: Balanced}