Instructions for Using AI PPT Interface
Parsing File Content#
Calling this interface (/302/ppt/parsefiledata) will convert the knowledge information required to generate a PPT into a dataUrl for use by subsequent interfacesRequest Parameters#
| Parameter Name | Type | Required | Description |
|---|
| file | File | No | File (limited to 50M, maximum parsing capacity of 20,000 characters) Supported formats: doc/docx/pdf/ppt/pptx/txt/md/xls/xlsx/csv/html/epub/mobi/xmind/mm |
| content | string | No | User-pasted text content |
| fileUrl | string | No | Public URL of the file |
| website | string | No | Website URL (http/https) |
| websearch | string | No | Web search keywords |
Usage Instructions#
file: Upload a local file directly. Supports multiple mainstream document formats. The file size should not exceed 50MB, and the content should not exceed 20,000 characters.
content: You can directly paste text content without uploading a file.
fileUrl: Enter the public URL of the file. The system will automatically download and parse it.
website: Enter the URL of a webpage. The system will parse the webpage content.
websearch: Enter keywords. The system will organize the content based on the results of web searches.
Note: All of the above parameters are optional. At least one of them must be filled in.
Generating a PPT#
1. Directly Generate a PPT#
This is the simplest method—directly call the interface (/302/ppt/directgeneratepptx) to create a PPT
Supports both streaming and non-streaming modes. The PPT file can be downloaded via the fileUrl returned by the interface
In the early stages of your project, you can use this method to quickly experience AiPPT’s features2. Asynchronous Streaming PPT Generation (Recommended)#
Thanks to most interfaces being able to return data in a streaming manner, this provides users with the best experience1.
Call the outline generation interface (/302/ppt/generateoutline, set the stream parameter to True) to generate the PPT outline directory in markdown format in a streaming manner
2.
Call the outline content generation interface (/302/ppt/generatecontent, set the stream parameter to True and the asyncGenPptxc parameter to True) to generate the complete outline content in markdown format based on the outline directory returned in step 1, and asynchronously generate the PPT
3.
In the second-step outline content generation interface, while receiving real-time streaming JSON data, check if the JSON contains a pptId. If it does, call the asynchronous PPT status query interface (/302/ppt/asyncpptinfo) to obtain the progress and data of the asynchronous PPT generation (rendered in real time on the frontend)
4.
The data from the third-step query interface is cached for only 30 seconds; once the task is completed, the cache will be cleared after 30 seconds. You can re-obtain the generated PPT link by calling the PPT download interface (/302/ppt/downloadpptx) and passing in the pptId
3. Synchronous Streaming PPT Generation#
1.
Call the outline generation interface (/302/ppt/generateoutline, set the stream parameter to True) to generate the PPT outline directory in markdown format in a streaming manner
2.
Call the outline content generation interface (/302/ppt/generatecontent, set the stream parameter to True and the asyncGenPptxc parameter to False) to generate the complete outline content in markdown format based on the outline directory returned in step 1
3.
Call the PPT generation interface (/302/ppt/generatepptx) to synthesize the PPT using the complete outline content in markdown format, and download it via the fileUrl
Modified at 2026-01-13 10:16:40