自定义模型配置适用于所有 Teable AI 功能，包括 AI Chat、AI 字段、App Builder 和自动化。自 2026 年 4 月 9 日起，Teable 的 Agent 引擎已完成升级，以提升 AI Chat Agent 模式和 App Builder 的 AI 能力。本次升级后，这些功能当前仅支持 Anthropic 兼容的 API 端点，使用不兼容的端点可能会导致报错。
- Cloud 用户（BYOK）： 如果您的自定义模型提供商不支持 Anthropic Messages API 格式，AI Chat Agent 和 App Builder 将无法使用您的 BYOK 配置。请切换至 Anthropic 兼容的提供商（如 Anthropic API、OpenRouter），或使用 Teable 默认模型。
- 私有化部署用户： 请确保您配置的 LLM 端点兼容 Anthropic 格式。您也可以等待我们后续适配 OpenAI 兼容端点后，拉取最新镜像即可。
- OpenAI 兼容端点支持已在规划中，将在后续版本中推出。
推荐使用 Teable Credits： Teable Credits 当前以成本价提供，没有中间商赚差价，让您以最优惠的价格使用顶级 AI 模型，体验最流畅。 在空间中集成 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/。
Teable 不支持 coding plan 的 Key。请使用提供商后台创建的标准 API Key。因为 coding plan 的 Key 通常只能在指定的 coding 工具中使用，不能作为通用 API Key 接入 Teable。若您使用这类 Key，模型测试失败是正常现象。
| 提供商 | 基础 URL 格式 |
|---|
| Anthropic | https://api.anthropic.com/v1 |
| OpenAI | https://api.openai.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.4, gpt-5.4-mini, gpt-5 |
| Anthropic | claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5 |
| Google | gemini-3.1-pro-preview, gemini-3-flash, gemini-2.5-flash |
| Azure | gpt-5.4, gpt-5, gpt-5-mini, gpt-4o |
| DeepSeek | deepseek-chat, deepseek-reasoner |
| XAI | grok-4, grok-4.1-fast |
| 通义千问 | qwen3.5-plus, qwen3-max |
| OpenRouter | anthropic/claude-opus-4-6, google/gemini-3.1-pro-preview |
| TogetherAI | deepseek-ai/DeepSeek-R1, meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8 |
| Mistral | mistral-large-latest, mistral-medium-latest, codestral-latest |
| Ollama | qwen3.5:9b, gemma3:12b, llama3.2:8b |
- 模型名称区分大小写 - 请使用提供商文档中的准确名称
- 部分提供商要求逗号后不要加空格（如
gpt-4o,gpt-4-turbo）
- OpenRouter 格式为：
提供商/模型名称（如 openai/gpt-4o）
- Azure 请使用您在 Azure AI Foundry（或 Azure OpenAI Studio）中创建的部署名称，而非基础模型名。例如，如果您将
gpt-5.4 部署为 my-gpt54，则填写 my-gpt54
- 您可以在之后通过更新提供商配置来添加更多模型
常见问题排查
| 问题 | 解决方案 |
|---|
| 所有模型测试失败 | 检查基础 URL 末尾是否多了斜杠 (/)，如有请移除。同时确认 API Key 已启用所需的 API 服务（如 Google 需启用 Generative Language API） |
| “测试失败”错误 | 检查 API Key 是否有效且有足够额度 |
| 连接超时 | 检查基础 URL 是否正确且可访问 |
| 找不到模型 | 确保模型名称与提供商文档完全一致 |
| 使用 coding plan 的 Key 测试失败 | Teable 不支持这类 Key。请到提供商后台重新创建标准 API Key 后再测试 |
| 无法启用自定义模型 | 确保已配置 Chat 模型 |
| App Builder 或 AI Chat Agent 无法使用自定义模型 | 自 2026 年 4 月 9 日起，这些功能当前仅支持 Anthropic 兼容端点。请切换至 Anthropic 兼容的提供商（如 Anthropic API、OpenRouter）、使用 Teable 默认模型，或等待后续 OpenAI 端点适配 |
除了设置空间级别的 AI 模型，管理员还可以在管理员面板中配置实例级别的 AI 设置（私有化版本可用）。
