自定义模型配置适用于 AI Chat、AI 字段和自动化。App Builder 目前不支持 BYOK —— 它使用系统默认模型，无法切换为自定义模型。
在空间中集成 AI 模型
- 打开一个空间：首先，在 Teable 中导航并进入您希望集成 AI 模型的特定空间。
- 进入设置界面：在当前空间的界面中，找到并点击右上角的”设置”选项。
- 进入 AI 设置：在设置菜单中，选择并点击”AI 设置”。
- 添加 LLM 提供商：在 AI 设置界面，点击”+ 添加 LLM 提供商”按钮。
- 配置提供商信息：
- 为您的模型提供商提供一个名称（如 “OpenAI”、“Claude”）。
- 选择提供商类型（OpenAI、Anthropic、Google 等）。
- 设置您的模型提供商的基础 URL。
- 输入相应的 API Key。
- 输入模型名称（用逗号分隔，如
gpt-4o, gpt-4-turbo）。
- 完成添加：配置完成后，点击”添加”按钮。
-
配置模型偏好：添加提供商后，配置使用的模型：
- Chat 模型 - 用于 AI Chat、规划、编码和其他复杂推理任务。推荐：
claude-opus-4-6（启用自定义模型必须配置）
-
启用自定义模型：切换开关以启用您的自定义模型配置。
完成以上步骤后，您将能够在 Teable 的 AI 功能中看到”空间模型”和”系统模型”的区分。您刚刚配置的 AI 模型将显示在”空间”栏目下。
配置提示
基础 URL 填写指南
基础 URL 必须是 API 端点地址，而不是提供商的网站地址。请确保包含完整路径（通常以 /v1 或类似后缀结尾）。请勿在 URL 末尾添加斜杠 (/)——例如，应使用 https://generativelanguage.googleapis.com/v1beta 而非 https://generativelanguage.googleapis.com/v1beta/。
| 提供商 | 基础 URL 格式 |
|---|
| 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://{您的资源名称}.openai.azure.com |
| Mistral | https://api.mistral.ai/v1 |
| 通义千问 | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| 智谱 AI | 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 (本地) | http://localhost:11434 |
模型名称填写指南
请按照提供商指定的格式准确输入模型名称。多个模型之间用逗号分隔。
| 提供商 | 模型名称示例 |
|---|
| 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 |
| 通义千问 | 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 |
- 模型名称区分大小写 - 请使用提供商文档中的准确名称
- 部分提供商要求逗号后不要加空格（如
gpt-4o,gpt-4-turbo）
- OpenRouter 格式为：
提供商/模型名称（如 openai/gpt-4o）
- 您可以在之后通过更新提供商配置来添加更多模型
常见问题排查
| 问题 | 解决方案 |
|---|
| 所有模型测试失败 | 检查基础 URL 末尾是否多了斜杠 (/)，如有请移除。同时确认 API Key 已启用所需的 API 服务（如 Google 需启用 Generative Language API） |
| “测试失败”错误 | 检查 API Key 是否有效且有足够额度 |
| 连接超时 | 检查基础 URL 是否正确且可访问 |
| 找不到模型 | 确保模型名称与提供商文档完全一致 |
| 无法启用自定义模型 | 确保已配置 Chat 模型 |
除了设置空间级别的 AI 模型，管理员还可以在管理员面板中配置实例级别的 AI 设置（私有化版本可用）。