> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 自定义 AI 模型

> 为 AI 字段、自动化等功能添加自定义模型提供商。

<Tip>Pro 版及以上适用</Tip>

<Note>
  自定义模型配置适用于 **AI 字段**、**自动化** 等模型调用功能。

  2026 年 6 月 24 日，Teable 重构了 **Agent Computer**，提升了 **AI 对话** 和 **应用构建器** 中 Cuppy 的处理速度和长任务稳定性。Agent Runtime 的 BYOK 兼容正在进行中。

  **推荐使用 Teable Credits：** Teable Credits 当前以成本价提供，没有中间商赚差价，让您以更优惠的价格使用顶级 AI 模型，并获得更稳定的体验。
</Note>

配置完成后，添加的模型可以供当前空间内已支持的模型调用功能使用。

## 配置入口

1. 打开目标空间。
2. 点击右上角 **设置**。
3. 进入 **AI 配置**。

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/ai/2026-05-21-custom-model-ai-settings.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=719ff403a81baa5e91656734a04469d4" alt="AI 配置页面" className="docs-screenshot" width="1600" height="978" data-path="images/docs/ai/2026-05-21-custom-model-ai-settings.png" />

## 配置步骤

在 **AI 能力** 中按需开启：

* **AI 字段**
* **AI 聊天**

开启 **AI 聊天** 只表示允许空间使用聊天功能。Agent Runtime 的 BYOK 兼容正在进行中。

### 添加模型提供商

点击 **添加模型提供商**，填写以下信息：

* **名称**：用于区分不同的模型提供商。
* **提供商类型**：选择服务商类型。
* **基础 URL**：填写服务商的 API 地址。
* **API 密钥**：填写服务商提供的 API 密钥。
* **模型**：填写要接入的模型名称，多个模型之间使用英文逗号分隔。

<img src="https://mintcdn.com/teablecn/TO9j-Q8_3sjEReNV/images/docs/ai/2026-05-21-custom-model-add-provider.png?fit=max&auto=format&n=TO9j-Q8_3sjEReNV&q=85&s=6f34465ed2c68d3f5f64280bb77d9a5e" alt="添加模型提供商弹窗" className="docs-screenshot" width="1600" height="974" data-path="images/docs/ai/2026-05-21-custom-model-add-provider.png" />

### 测试模型能力

当前支持三种测试方式：

* 在模型提供商行点击 **测试**。
* 在单个模型行点击 **测试**。
* 在列表右上角点击 **测试模型能力**，批量测试全部已配置模型。

如果某个模型用于图片生成，请先勾选 **生图模型** 再执行测试。勾选后会按生图模型测试 **文生图** 和 **图生图** 能力；未勾选时，则按普通文本模型测试。

## 填写提示

### 基础 URL

<Warning>请填写 API 端点地址，而不是服务商官网地址。多数 OpenAI 兼容接口需要以 `/v1` 结尾；除非服务商文档明确要求，否则不要在 URL 末尾额外加 `/`。</Warning>

<Warning>部分 Coding Plan Key 可能只允许在指定开发工具中使用，并不是标准 API Key。是否可用于第三方服务，请以对应提供商的条款和说明为准；如需接入 Teable，请使用提供商后台创建的标准 API Key。</Warning>

用于已支持的模型调用时，常见基础 URL 示例：

| 提供商        | 基础 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`                            |

### 模型

<Note>模型名称必须与服务商文档一致，并区分大小写。多个模型之间使用英文逗号分隔。</Note>

用于已支持的模型调用时，常见模型名称示例：

| 提供商        | 模型名称示例                                                                       |
| ---------- | ---------------------------------------------------------------------------- |
| 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 中创建的部署名称，而不是基础模型名。

## 常见问题

<AccordionGroup>
  <Accordion title="所有模型测试失败">
    先检查 **基础 URL** 是否正确，是否误填成官网地址，或在末尾多加了 `/`。如果使用的是 OpenAI 兼容接口，也请确认地址是否缺少 `/v1`。
  </Accordion>

  <Accordion title="出现“测试失败”错误">
    检查 **API 密钥** 是否有效，以及账户是否仍有额度或调用权限。
  </Accordion>

  <Accordion title="连接超时">
    检查 **基础 URL** 是否正确，且当前环境可以访问这个地址。
  </Accordion>

  <Accordion title="找不到模型">
    确认 **模型** 与服务商文档完全一致，包括大小写和分隔格式。
  </Accordion>

  <Accordion title="使用 coding plan 的 Key 测试失败">
    这类 Key 可能不支持标准 API 调用，或提供商条款不允许用于第三方服务。请先查看对应 Coding Plan 的条款；如需接入 Teable，请使用服务商后台创建的标准 **API 密钥**。
  </Accordion>

  <Accordion title="生图模型测试结果不对">
    如果这个模型本来用于图片生成，请先勾选 **生图模型**，再重新测试。勾选后会改为测试文生图和图生图能力。
  </Accordion>
</AccordionGroup>