How to navigate to this page
Open the left sidebar → Workspace Settings → AI Models. The page opens on the Providers tab by default. Click the LLM tab to configure language models.Only workspace admins and owners can access the AI Models settings page.
Add your first LLMs model
1
Open AI Models settings
Open the left sidebar → Workspace Settings → AI Models.
2
Go to the LLMs tab
The page opens on the Providers tab. Click the LLMs tab.
3
Find your provider
Browse the provider cards or use the search box to filter by name.
4
Open the configuration panel
Click Configure on the provider card. A configuration panel slides open.
5
Fill in the required fields
Enter the credentials required for your provider (API key, endpoint URL, etc.). See the provider reference below.
6
Set optional fields (if needed)
- Model Friendly Name — a human-readable label shown in chat (e.g. “My GPT-5”). Optional.
- Context Length — token window override (1–1,000,000). Leave blank to use the provider default.
- Multimodal toggle — enable if this model can accept image input. On by default.
- Reasoning toggle — enable for chain-of-thought / o-series style models. Off by default.
7
Save and validate
Click Add Model. Novaplan AI runs a live health check to validate your credentials.
8
First model becomes the default
If this is the first LLMs model you’ve added, it is automatically set as the default model used by all AI features.
Provider reference
The table below lists LLM providers, their configuration fields, and example model names. Model access varies by provider account, and each model must be tested with your Novaplan AI workspace before production use.Azure OpenAI — Deployment Name: This is the name you assigned when deploying the model in Azure AI Studio, not the model ID itself. Azure AI — Endpoint URL format: Copy the endpoint shown for your Foundry deployment. Claude’s Messages API commonly useshttps://<resource>.services.ai.azure.com/anthropic; OpenAI-compatible deployments use a resource-specific/openai/v1/endpoint. Check the Azure AI guide and confirm that Novaplan supports the deployment’s API format. OpenAI Compatible: Use this for any provider that speaks the OpenAI API format (e.g.https://api.together.xyz/v1/). Ollama: A standard Ollama service does not require an API key. The application default ishttp://host.docker.internal:11434, but use it only if Novaplan confirms that the managed workspace can reach the service through that hostname. Amazon Bedrock: Leave the AWS key fields blank only when Novaplan has configured an approved AWS credential source for the managed backend, such as a workload role. Credentials on your own computer are not used automatically.
Managing configured models
After saving, your model appears under the Configured tab. Each row has the following actions:- Edit — update credentials or settings without deleting the configuration.
- Set as Default — make this model the one used by all AI features by default.
- Delete — permanently remove the configuration. You will be asked to type the model’s name to confirm.
Troubleshooting
If the health check fails when saving, double-check:
- The API key is correct and has not expired.
- For Azure providers, the endpoint URL matches the correct region and resource.
- For Ollama, Novaplan has confirmed the endpoint is reachable from the managed workspace.
- The model name string exactly matches what the provider API expects (check the provider’s documentation for valid model IDs).
Embedding models
Embedding models convert documents and search queries into numerical vectors so Novaplan AI can find semantically similar content. They power document indexing, semantic search, and retrieval across your workspace. At least one embedding model must be configured before you can index documents or use search. Novaplan AI ships with BAAI/bge-large-en-v1.5 built-in as the system default — it works out of the box with no configuration required. Connect an external provider only if you need a different model.How to navigate to this page
Open the left sidebar → Workspace Settings → AI Models. Click the Embedding tab.Only workspace admins and owners can access the AI Models settings page.
Add an embedding model
1
Open AI Models settings
Open the left sidebar → Workspace Settings → AI Models.
2
Go to the Embedding tab
Click the Embedding tab in the capability row.
3
Find your provider
Browse the provider cards or use the search box to filter by name.
4
Open the configuration panel
Click Configure on the provider card. A configuration panel slides open.
5
Fill in the required fields
Enter the credentials required for your provider. See the provider reference below.
6
Set optional fields (if needed)
- Model Friendly Name — a human-readable label for this configuration.
- Output Dimensions — override the vector size (1–65,536). Leave blank to use the model default. Only supported by select models (e.g. OpenAI text-embedding-3-* series).
- Multimodal toggle — enable if this model can embed images as well as text (off by default).
7
Save and validate
Click Add Model. Novaplan AI runs a live health check to validate your credentials.
8
First model becomes the default
If this is the first embedding model you have added, it is automatically set as the default used for all document indexing and search.
Embedding provider reference
Azure OpenAI — Deployment Name: This is the name you assigned when deploying the model in Azure, not the model ID itself. Azure AI — Endpoint URL format:https://<resource>.services.ai.azure.com/openai/v1/OpenAI Compatible: Use this for any provider that speaks the OpenAI embeddings API format. Ollama: A standard Ollama service does not require an API key. Its application default ishttp://host.docker.internal:11434; Novaplan must confirm that the managed workspace can reach the actual model server. Sentence Transformers / HuggingFace: Run locally inside Novaplan AI. No external API or API key needed. Amazon Bedrock: Leave AWS key fields blank only when Novaplan has configured an approved AWS credential source for the managed backend. Provider dropdown: Cohere, Amazon (Titan), Other.
Managing configured embedding models
After saving, your model appears under the Configured tab. Each row has the following actions:- Edit — update credentials or settings without deleting the configuration.
- Set as Default — make this model the one used for all new document indexing and search.
- Delete — permanently remove the configuration. You will be asked to type the model’s name to confirm.
Changing the default embedding model does not automatically re-index existing documents.
Documents indexed with the old model and queries run with the new model use different vector spaces, which will degrade search quality. Re-index your documents after switching embedding models.
Troubleshooting
If the health check fails when saving, double-check:
- The API key is correct and has not expired.
- For Azure providers, the endpoint URL matches the correct region and resource.
- For Ollama, Sentence Transformers, and HuggingFace, confirm the model name is available locally.
- The model name exactly matches what the provider API expects (check provider docs for valid IDs).
- Output Dimensions is only supported by models that expose a dimensions parameter (e.g. OpenAI text-embedding-3-* series). Setting it on unsupported models will cause errors.
Image Generation models
Image generation models allow AI agents and workflows in Novaplan AI to generate images from text prompts. Once configured, these models are available to agents that support image creation tasks. At least one image generation model must be configured before image generation features are available in your workspace. The accessible provider catalog includes OpenAI, Gemini, OpenRouter, and LiteLLM Proxy for image generation. Check which options your managed workspace actually exposes before choosing a model.How to navigate to this page
Open the left sidebar → Workspace Settings → AI Models. Click the Image Generation tab.Only workspace admins and owners can access the AI Models settings page.
Add an image generation model
1
Open AI Models settings
Open the left sidebar → Workspace Settings → AI Models.
2
Go to the Image Generation tab
Click the Image Generation tab in the capability row.
3
Open the configuration panel
Click Configure on the provider card you want to use.
4
Fill in the required fields
Enter the required fields shown for that provider. A LiteLLM Proxy connection also needs its reachable Endpoint URL. See the provider reference below.
5
Set an optional friendly name
Optionally set a Model Friendly Name — a human-readable label displayed in the UI.
6
Save and validate
Click Add Model. Novaplan AI runs a live health check to validate your credentials.
7
First model becomes the default
If this is the first image generation model you have added, it is automatically set as the default used when image generation is triggered.
Image generation provider reference
OpenAI: Get your API key at platform.openai.com/api-keys. Gemini: Get your API key at aistudio.google.com/app/apikey. Imagen models require a Google Cloud project with the Vertex AI API enabled, or access via Google AI Studio.
Managing configured image generation models
After saving, your model appears under the Configured tab. Each row has the following actions:- Edit — update credentials or the model name.
- Set as Default — make this the model used when image generation is triggered.
- Delete — permanently remove the configuration. You will be asked to type the model’s name to confirm.
Troubleshooting
If the health check fails when saving, double-check:
- The API key is correct and has not expired.
- The model name exactly matches a currently available model in the provider account or proxy configuration; a legacy placeholder in the workspace may be outdated.
- For Gemini Imagen models, confirm your API key has access to image generation — not all Google AI Studio keys have Imagen enabled by default.
Text to Speech (TTS) models
Text to Speech models convert AI text responses into spoken audio, enabling voice output in AI workflows and agents. Once configured, these models are available wherever Novaplan AI produces audio output. At least one TTS model must be configured before voice features are available in your workspace. The accessible provider catalog includes OpenAI, Gemini, OpenRouter, and LiteLLM Proxy for TTS. Check availability and supported voices in your managed workspace and chosen model.How to navigate to this page
Open the left sidebar → Workspace Settings → AI Models. Click the TTS tab.Only workspace admins and owners can access the AI Models settings page.
Add a TTS model
1
Open AI Models settings
Open the left sidebar → Workspace Settings → AI Models.
2
Go to the TTS tab
Click the TTS tab in the capability row.
3
Open the configuration panel
Click Configure on the provider card you want to use.
4
Fill in the required fields
Enter the required fields shown for that provider. LiteLLM Proxy also needs its reachable Endpoint URL. See the provider reference below.
5
Choose optional settings
- Voice — select a default voice for audio output.
- Audio Format — select the output audio format.
- Model Friendly Name — a custom display label for this configuration.
6
Save and validate
Click Add Model. Novaplan AI validates your credentials with a live health check.
7
First model becomes the default
If this is the first TTS model you have added, it is automatically set as the default used for all TTS output.
TTS provider reference
OpenAI voices: Alloy, Echo, Fable, Onyx, Nova, Shimmer. Get your API key at platform.openai.com/api-keys. OpenAI audio formats: MP3, Opus, AAC, FLAC, WAV. Gemini voices: 30 prebuilt voices named after astronomical objects — Zephyr, Puck, Charon, Kore, Fenrir, Leda, Orus, Aoede, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat. Get your API key at aistudio.google.com/app/apikey. Gemini audio formats: WAV and PCM do not require server-side transcoding. MP3, Opus, AAC, and FLAC require ffmpeg on the Novaplan-managed backend; Novaplan Support can check its availability.
Managing configured TTS models
After saving, your model appears under the Configured tab. Each row has the following actions:- Edit — update credentials, voice, or format settings.
- Set as Default — make this the model used for all TTS output.
- Delete — permanently remove the configuration. You will be asked to type the model’s name to confirm.
Troubleshooting
If the health check fails when saving, double-check:
- The API key is correct and has not expired.
- The model name exactly matches what the provider API expects (e.g.
tts-1, notTTS-1). - For Gemini compressed formats (MP3, Opus, AAC, FLAC), ask Novaplan Support to check ffmpeg on the managed backend. WAV and PCM do not require this transcoding dependency.
Speech to Text (STT) models
Speech to Text models transcribe spoken audio into text, enabling voice input in AI workflows and agents. Once configured, these models power voice-driven interactions across your Novaplan AI workspace. The accessible catalog has six STT options: OpenAI, Gemini, OpenRouter, LiteLLM Proxy, Whisper (inference throughfaster-whisper on the Novaplan-managed backend), and Wispr Flow. Check which are available in your deployed workspace. At least one STT model must be configured before voice input features are available.
How to navigate to this page
Open the left sidebar → Workspace Settings → AI Models. Click the STT tab.Only workspace admins and owners can access the AI Models settings page.
Add an STT model
1
Open AI Models settings
Open the left sidebar → Workspace Settings → AI Models.
2
Go to the STT tab
Click the STT tab in the capability row.
3
Open the configuration panel
Click Configure on the provider card you want to use.
4
Fill in the required fields
Enter the fields shown for your provider (including the reachable Endpoint URL for LiteLLM Proxy, or a Model size for local Whisper). See the provider reference below.
5
Adjust optional settings
Configure any optional settings such as language, device, compute type, or app type depending on your provider.
6
Set an optional friendly name
Optionally set a Model Friendly Name — a custom label shown in the UI.
7
Save and validate
Click Add Model. Novaplan AI validates your configuration with a live health check.
8
First model becomes the default
If this is the first STT model you have added, it is automatically set as the default used for all speech transcription.
STT provider reference
OpenAI: Get your API key at platform.openai.com/api-keys.
Gemini: Get your API key at aistudio.google.com/app/apikey.
Whisper (local): No third-party transcription API key is required. faster-whisper runs on the Novaplan-managed backend, and model weights are downloaded from Hugging Face on first use. Optional: Device (Auto/CPU/CUDA), Compute Type (int8/float16/float32), Model Cache Directory.
Wispr Flow: Contact enterprise@wisprflow.ai to obtain an API key. Novaplan must have ffmpeg available on the managed backend. Optional: Default Language, App Type, API Endpoint override.
Managing configured STT models
After saving, your model appears under the Configured tab. Each row has the following actions:- Edit — update credentials or settings.
- Set as Default — make this the model used for all speech transcription.
- Delete — permanently remove the configuration. You will be asked to type the model’s name to confirm.
Troubleshooting
If the health check fails when saving, double-check:
- For OpenAI and Gemini: the API key is correct and has not expired.
- For Whisper (local): ask Novaplan Support to check
faster-whisper, model downloads, and backend connectivity. - For Wispr Flow: confirm your API key is active (contact enterprise@wisprflow.ai if unsure). Ask Novaplan Support to check ffmpeg on the managed backend.