Generate Thumbnail
Generate a thumbnail from a file upload or URL.
File Upload: Use multipart/form-data with a file field.
URL Fetch: Use JSON body with url field. Optionally include url_headers for authenticated URLs.
Options:
width,height: Max dimensions (default 600x400)quality: JPEG quality 1-100 (default 95)sync: Wait for result (true) or return job ID (false)webhook_url: URL to POST result when complete (async only)response_type: “url” returns storage URL, “base64” returns encoded image
Headers
Body
File to generate thumbnail from
URL to fetch file from
JSON-encoded headers for URL auth
Max thumbnail width
50 <= x <= 2000Max thumbnail height
50 <= x <= 2000JPEG quality
1 <= x <= 100Wait for result or return job ID
Webhook URL for async completion
Response type: 'url' or 'base64'
Response
Successful Response
Response for a completed thumbnail generation.
Unique job identifier
Thumbnail metadata
Job processing status.
pending, processing, completed, failed URL to the thumbnail image
Base64-encoded thumbnail (if response_type='base64')