Available for Pro plan and above
Custom model configuration applies to AI Chat, AI Fields, and Automations. App Builder currently does not support BYOK — it uses the system default model and cannot be switched to a custom model.
Integrate AI Models in Teable
Steps:
- Open a Space: First, navigate to and enter the specific space in Teable where you want to integrate the AI model.
- Access Settings: In the current space’s interface, locate and click the “Settings” option in the top right corner.
- Go to AI Settings: In the settings menu, select and click “AI Settings.”
- Add LLM Provider: Click the ”+ Add LLM provider” button.
- Configure Provider Information:
- Provide a name for your model provider (e.g., “OpenAI”, “Claude”).
- Select the provider type (OpenAI, Anthropic, Google, etc.).
- Set your model provider’s Base URL.
- Enter the corresponding API Key.
- Enter the model names (comma-separated, e.g.,
gpt-4o, gpt-4-turbo).
- Complete Addition: Once configured, click the “Add” button.
-
Configure Model Preferences: After adding the provider, configure which model to use:
- Chat model - For AI Chat, planning, coding, and other complex reasoning tasks. Recommended:
claude-opus-4-6 (required to enable custom model)
-
Enable Custom Model: Toggle the switch to enable your custom model configuration.
After completing these steps, you’ll see a distinction between “Space Models” and “System Models” within Teable’s AI features. The AI model you just configured will appear under the “Space” section.
Configuration Tips
Base URL Guidelines
The Base URL must be the API endpoint URL, not the provider’s website URL. Make sure to include the complete path (usually ending with /v1 or similar). Do not include a trailing slash (/) at the end of the URL — for example, use https://generativelanguage.googleapis.com/v1beta instead of https://generativelanguage.googleapis.com/v1beta/.
| Provider | Base URL Format |
|---|
| OpenAI | https://api.openai.com/v1 |
| Anthropic | https://api.anthropic.com/v1 |
| Google | https://generativelanguage.googleapis.com/v1beta |
| DeepSeek | https://api.deepseek.ai/v1 |
| Azure | https://{your-resource-name}.openai.azure.com |
| Mistral | https://api.mistral.ai/v1 |
| Qwen | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Zhipu | https://open.bigmodel.cn/api/paas/v4 |
| XAI (Grok) | https://api.x.ai/v1 |
| OpenRouter | https://openrouter.ai/api/v1 |
| TogetherAI | https://api.together.xyz/v1 |
| Ollama (Local) | http://localhost:11434 |
Models Field Guidelines
Enter model names exactly as specified by your provider. Multiple models should be separated by commas.
| Provider | Example Models |
|---|
| OpenAI | gpt-5.2, o3, gpt-4o-mini |
| Anthropic | claude-sonnet-4-6, claude-opus-4-6, claude-sonnet-4-5 |
| Google | gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-flash-preview |
| DeepSeek | deepseek-chat, deepseek-reasoner |
| XAI | grok-4, grok-4-fast |
| Qwen | qwen3.5-plus, qwen3-max |
| OpenRouter | anthropic/claude-sonnet-4-6, google/gemini-2.5-flash |
| TogetherAI | deepseek-ai/DeepSeek-R1, meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8 |
| Mistral | mistral-large-latest, codestral-latest |
| Ollama | qwen3:8b, gemma3:12b, llama3.2:8b |
- Model names are case-sensitive - use the exact names from your provider’s documentation
- Do not add spaces after commas for some providers (e.g.,
gpt-4o,gpt-4-turbo)
- For OpenRouter, use the format:
provider/model-name (e.g., openai/gpt-4o)
- You can add models later by updating the provider configuration
Troubleshooting
| Issue | Solution |
|---|
| All model tests failed | Check if your Base URL ends with a trailing slash (/) and remove it. Also verify your API key has the required API enabled (e.g., Generative Language API for Google) |
| “Test failed” error | Verify your API key is valid and has sufficient credits |
| Connection timeout | Check if your Base URL is correct and accessible |
| Model not found | Ensure the model name matches exactly with the provider’s documentation |
| Cannot enable custom model | Make sure you’ve configured the Chat model first |
In addition to setting up space-level AI models, administrators can also configure instance-level AI settings in the Admin Panel (available in SaaS and self-hosted versions).
