API features
PowerPoint slide previews
Convert PPT and PPTX presentations into static PNG images.
Ordered slide images
Receive one image per slide, including hidden and blank slides, in source order.
Adjustable image dimensions
Choose a rendering scale from 1 to 4 for your display workflow.
Upload or link input
Send a presentation file or a publicly accessible file URL.
Downloadable PNG files
Use public image links for previews and save files you need to keep.
Presentation review workflows
Add slide previews to document review, catalogs and approval tools.
API Document
HTTP Protocol:HTTPS
HTTP Method:POST
HTTP Endpoint:https://api.gugudata.io/v1/imagerecognition/ppt-to-images
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/imagerecognition/ppt-to-images/demo
Live Demo:Try Interactive Demo
Postman Collection:Run in Postman
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | API key used to authenticate the request. |
| file | file | false | Upload a PPT or PPTX presentation. Provide exactly one of file or file_url. Maximum 20 MiB and 50 slides. | |
| file_url | string | false | Public HTTP(S) presentation URL, up to 2048 characters. Provide exactly one of file or file_url. | |
| scale_factor | integer | false | 1 | Rendering scale. Values below 1 use 1; values above 4 use 4. Maximum image edge 8192 pixels and 32 megapixels per image. |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| data | array<string> | Ordered public HTTPS PNG URLs, one per slide, including hidden and blank slides. dataStatus.dataTotalCount is the image count. Save files you need to keep; permanent hosting is not guaranteed. |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 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. |
| 413 | Presentation exceeds input limits. | Use at most 20 MiB and 50 slides. |
| 422 | Presentation cannot be rendered within supported limits. | Use a valid unencrypted PPT or PPTX and reduce slide dimensions if necessary. |
| 429 | Request rate or trial usage limit exceeded. | Reduce request frequency and retry with backoff. If a trial allowance is exhausted, check Trial Keys for remaining requests and subscribe to continue. |
| 500 | Internal service error. | Retry later or contact support if the error persists. |
| 502 | Download or conversion failed or timed out. | Check the file link and try again later. |
| 503 | Conversion is temporarily unavailable. | Try again later. |
Remote MCP
Use this API through GuGuData Remote MCP
Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.
https://mcp.gugudata.io/mcp{
"mcpServers": {
"gugudata": {
"url": "https://mcp.gugudata.io/mcp",
"transportType": "streamable-http"
}
}
}Code Snippets
Frequently asked questions
What image format does the presentation API return?
It returns an ordered list of public HTTPS PNG URLs, one per slide. Use the images for slide previews, review screens, or document-processing workflows.
Can I upload PPT and PPTX files or use a remote URL?
Yes. Provide either file or a public HTTP or HTTPS file_url. The documented source limit is 20 MiB and fifty slides; a remote URL can be up to 2,048 characters.
Can I increase the resolution of the slide images?
Use scale_factor. Values below one use one, and values above four use four. Output remains subject to an 8,192-pixel maximum edge and a 32-megapixel limit per image.
Are hidden and blank slides exported?
Yes. The documented PNG output includes hidden and blank slides in source order. Keep that order if you need image positions to correspond to the original slide sequence.
Does this endpoint turn slide animations into moving images?
No. Each result is a static PNG of a slide. Download the images you need to retain, and use a different workflow if your requirement is video or animation playback.
What does the 5 requests per second limit mean?
It is a request-rate limit, not a concurrency allowance. Keep your request rate at or below 5 per second. If the service returns a rate-limit response, reduce the frequency and retry with backoff.
Is total paid usage limited?
There is no total request cap during an active paid subscription and no usage-based overage charge.
How does the free trial work?
Each account can receive a limited trial key. Requests are shared across APIs in the same category. Check Trial Keys for the exact allowance and remaining requests.
How do renewal and cancellation work?
The plan renews annually until canceled. Manage or cancel the renewal from Dashboard → Orders & Billing. Access continues through the paid period after cancellation. See the Terms of Service for the current refund policy. If the billing portal is unavailable, contact support.
Service terms
Read our service terms and privacy policy before subscribing.
