Convert PPT to Images
Convert an uploaded PowerPoint file into page images and return the generated asset list defined by the current v1 contract.
Method: POST
Path: /v1/imagerecognition/ppt-to-images
Demo: https://api.gugudata.io/v1/imagerecognition/ppt-to-images/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json
Request Parameters:
- appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.
- file (file, required): Local file uploaded as multipart form data.
- scale_factor (integer, optional): Rendering scale factor applied during PowerPoint image conversion.
Response Fields:
- images (array, required): Array of CDN URLs for generated slide images in PNG format
HTTP Status Codes:
- 200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as
dataStatus.statusCode.
- 400: Invalid request parameters or request format. Check required fields, data types, and request body format.
- 401: Missing or unknown application key. Provide a valid
appkey with the request.
- 403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.
- 429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.
- 500: Internal service error. Retry later or contact support if the error persists.
- 503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.
Business Status Codes:
- 200 Normal return: PPT successfully converted and image URLs returned
- 400 Parameter error: Invalid or missing required parameters, or unsupported file format
- 429 Request frequency limited: Cannot exceed 100 requests per second
- 403 Account in arrears: Payment required to continue using the service
- 402 APPKEY error: Please check whether the APPKEY passed is obtained from the developer center
- 500 API response error: Internal server error during PPT processing
- 503 Service unavailable: External service temporarily unavailable
Key Features:
- Support converting PPTX PowerPoint presentations to high-quality PNG images.
- Customizable scale factor for image quality and size control.
- Each slide converted to separate image file for easy access.
- Automatic upload to Cloudflare R2 CDN for fast global delivery.
- Maintains original slide layout and formatting.
- Support for complex presentations with animations and transitions.
- Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3).
- Fully compatible with Apple ATS.
- Nationwide multi-node CDN deployment.
- Ultra-fast response, API interface load balancing built with multiple servers.
Details:
https://gugudata.io/details/ppt2images