Creating a custom deck is perfect for use cases where you want to create a presentation with a variable number of slides (depending on the prompt). If you have a repeated deck creation use case, where you want the same set slides but with content tailored to the prompt, you should create a deck from a template.
You can view your available FlashDocs templates and libraries here: dash.flashdocs.ai

​
Hello World

Below is the simplest deck generation request we can make. Just specify a prompt and the backend takes care of the rest. 
curl --request POST \
  --url https://api.flashdocs.ai/v3/generate/deck \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Make a slide deck explaining why programmatic slide deck creation is a game changer for my business. Describe all of the new features we can add."
}'

Generate Slides Endpoint

View the API Reference

​
Overview of Custom Deck Generation Process

1

Slide Source: The request does not specify a source_document_id, so the system fetches any (Google Slides / PPTX) library document that is in your organization.

2

Slide Count: The request does not specify a number of slides (number_slides), so the system estimates an appropriate number of slides based on the prompt.

3

Outline Generation: The request does not specify an outline, so the system creates an outline (content & slide layout description for each slide) based on the slide count and prompt.

4

Slide Selection: The request does not include an outline parameter with the slide_id key, so the system selects the most relevant slide from the slide source (library document in step 1) given the outline layout description for each slide.

5

Generation: For each selected slide, the system uses the prompt + outline + placeholders in the slide to generate content for each of the selected slides.

​
Want More Configuration Options?

Complete Generation Control. If you want to see more details on how you can completely control the deck generation through the various parameters: Generation Walkthrough