Skip to content

Commit 1e4fb72

Browse files
authored
Merge pull request #186 from barun-saha/visual
Add models and naming convention to API docs and project description
2 parents 128d056 + 4053c80 commit 1e4fb72

File tree

5 files changed

+44
-1
lines changed

5 files changed

+44
-1
lines changed

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,8 @@ SlideDeck AI stands out by supporting a wide array of LLMs from several online p
8787

8888
Most supported service providers also offer generous free usage tiers, meaning you can often start building without immediate billing concerns.
8989

90+
Model names in SlideDeck AI are specified in the `[code]model-name` format. It begins with a two-character prefix code in square brackets to indicate the provider, for example, `[oa]` for OpenAI, `[gg]` for Google Gemini, and so on. Following the code, the model name is specified, for example, `gemini-2.0-flash` or `gpt-4o`. So, to use Google Gemini 2.0 Flash Lite, the model name would be `[gg]gemini-2.0-flash-lite`.
91+
9092
Based on several experiments, SlideDeck AI generally recommends the use of Gemini Flash and GPT-4o to generate the best-quality slide decks.
9193

9294
The supported LLMs offer different styles of content generation. Use one of the following LLMs along with relevant API keys/access tokens, as appropriate, to create the content of the slide deck:

docs/generated/slidedeckai.cli.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
===============
33
===================================
44

5-
.. currentmodule:: slidedeckai.cli
5+
.. currentmodule:: slidedeckai
66

77
.. automodule:: slidedeckai.cli
88
:noindex:

docs/generated/slidedeckai.core.SlideDeckAI.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ slidedeckai.core.SlideDeckAI
1717
~SlideDeckAI.generate
1818
~SlideDeckAI.reset
1919
~SlideDeckAI.revise
20+
~SlideDeckAI.set_model
2021
~SlideDeckAI.set_template
2122

2223

docs/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ Please select a section below or choose a version in the bottom-left corner.
1212

1313
installation.md
1414
usage.md
15+
models.md
1516

1617
.. toctree::
1718
:maxdepth: 2

docs/models.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# Models
2+
3+
This section provides an overview of the large language models (LLMs) supported by SlideDeck AI for generating slide decks. SlideDeck AI leverages various LLMs to create high-quality presentations based on user inputs.
4+
5+
## Naming Convention
6+
7+
SlideDeck AI uses LiteLLM. However, the models here follow a different naming syntax. For example, to use Google Gemini 2.0 Flash Lite in SlideDeck AI, the model name would be `[gg]gemini-2.0-flash-lite`. This is automatically taken care of in the SlideDeck AI app when users choose any model. However, when using Python API, this naming convention needs to be followed.
8+
9+
In particular, model names in SlideDeck AI are specified in the `[code]model-name` format.
10+
- The first two-character prefix code in square brackets indicates the provider, for example, `[oa]` for OpenAI, `[gg]` for Google Gemini, and so on.
11+
- Following the code, the model name is specified, for example, `gemini-2.0-flash` or `gpt-4o`.
12+
13+
Note that not every LLM may be suitable for slide generation tasks. SlideDeck AI generally works best with the Gemini models. Some models can generate short contents. So, it is recommended to try out a few different models to see which one works best for your specific use case.
14+
15+
16+
## Supported Models
17+
18+
SlideDeck AI supports the following online LLMs:
19+
20+
| LLM | Provider (code) | Requires API key | Characteristics |
21+
|:------------------------------------|:-------------------------|:-------------------------------------------------------------------------------------------------------------------------|:-------------------------|
22+
| Claude Haiku 4.5 | Anthropic (`an`) | Mandatory; [get here](https://platform.claude.com/settings/keys) | Faster, detailed |
23+
| Gemini 2.0 Flash | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey) | Faster, longer content |
24+
| Gemini 2.0 Flash Lite | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey) | Fastest, longer content |
25+
| Gemini 2.5 Flash | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey) | Faster, longer content |
26+
| Gemini 2.5 Flash Lite | Google Gemini API (`gg`) | Mandatory; [get here](https://aistudio.google.com/apikey) | Fastest, longer content |
27+
| GPT-4.1-mini | OpenAI (`oa`) | Mandatory; [get here](https://platform.openai.com/settings/organization/api-keys) | Faster, medium content |
28+
| GPT-4.1-nano | OpenAI (`oa`) | Mandatory; [get here](https://platform.openai.com/settings/organization/api-keys) | Faster, shorter content |
29+
| GPT-5 | OpenAI (`oa`) | Mandatory; [get here](https://platform.openai.com/settings/organization/api-keys) | Slow, shorter content |
30+
| GPT | Azure OpenAI (`az`) | Mandatory; [get here](https://ai.azure.com/resource/playground) NOTE: You need to have your subscription/billing set up | Faster, longer content |
31+
| Command R+ | Cohere (`co`) | Mandatory; [get here](https://dashboard.cohere.com/api-keys) | Shorter, simpler content |
32+
| Gemini-2.0-flash-001 | OpenRouter (`or`) | Mandatory; [get here](https://openrouter.ai/settings/keys) | Faster, longer content |
33+
| GPT-3.5 Turbo | OpenRouter (`or`) | Mandatory; [get here](https://openrouter.ai/settings/keys) | Faster, longer content |
34+
| DeepSeek-V3.1-Terminus | SambaNova (`sn`) | Mandatory; [get here](https://cloud.sambanova.ai/apis) | Fast, detailed content |
35+
| Llama-3.3-Swallow-70B-Instruct-v0.4 | SambaNova (`sn`) | Mandatory; [get here](https://cloud.sambanova.ai/apis) | Fast, shorter |
36+
| DeepSeek V3-0324 | Together AI (`to`) | Mandatory; [get here](https://api.together.ai/settings/api-keys) | Slower, medium-length |
37+
| Llama 3.3 70B Instruct Turbo | Together AI (`to`) | Mandatory; [get here](https://api.together.ai/settings/api-keys) | Slower, detailed |
38+
| Llama 3.1 8B Instruct Turbo 128K | Together AI (`to`) | Mandatory; [get here](https://api.together.ai/settings/api-keys) | Faster, shorter |
39+

0 commit comments

Comments
 (0)