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

# 通用配置教程

> 适用于各类 AI 工具的通用 API 配置流程

市面上的 AI 工具很多，但供应商配置流程基本一致。本教程适用于支持自定义 API 供应商的对话客户端、编程工具和其他 AI 应用。

## 开始前

* 已 [创建 API 密钥](/create-token)
* 已确认 API 密钥所属的分组。分组决定了密钥可以调用哪些模型，具体对应关系请查看 [模型与分组](/modelandgroup)

## 配置步骤

<Steps>
  <Step title="设置供应商名称">
    在工具的供应商设置或自定义 API 设置中新增供应商。

    供应商名称可以按自己的习惯填写，例如 `Teio`。它只用于在工具中识别这套配置，不影响接口调用。
  </Step>

  <Step title="选择接口类型">
    接口类型默认选择 **OpenAI** 或 **OpenAI Compatible**。

    即使使用的是 Claude、Gemini 等模型，也可以通过 OpenAI 兼容接口接入。只有在工具明确要求 Anthropic、Gemini、Responses 或图片生成接口时，才切换到对应协议。
  </Step>

  <Step title="填写 URL 地址">
    API 地址支持以下写法，按工具输入框的名称选择对应格式即可：

    * `https://teio.me`
    * `https://teio.me/v1`
    * `https://teio.me/v1/chat/completions`
    * `https://teio.me/v1/responses`
    * `https://teio.me/v1/images/generations`
    * `https://teio.me/v1/messages`
    * `https://teio.me/v1beta/models/{model}:generateContent`

    如果工具的输入框标注为 **Base URL** 或 **API 地址**，优先填写 `https://teio.me/v1`。如果工具要求填写完整的请求地址，再根据接口类型选择带 `/chat/completions`、`/responses`、`/images/generations`、`/messages` 或 Gemini `generateContent` 的地址。
  </Step>

  <Step title="获取模型列表">
    点击工具中的 **获取**、**刷新** 或 **拉取模型**，等待模型列表返回。

    获取成功后，列表中显示的模型就是当前 API 密钥和分组可使用的模型。

    <Warning>
      如果接口返回 401，通常是没有配置 API Key，或填写的密钥无效。如果接口请求成功但返回的模型列表为空，通常是没有选择分组，或所选分组没有可用模型。如果接口返回的是 HTML 页面，通常是请求地址不完整，检查 Base URL 是否缺少 `/v1`。先检查 API Key、分组和 URL。
    </Warning>
  </Step>

  <Step title="设置默认模型">
    从模型列表中选择要使用的模型，设置为默认模型并保存配置。

    保存后即可回到工具主界面开始使用。
  </Step>
</Steps>

## 配置示例

| 配置项     | 示例值                            |
| ------- | ------------------------------ |
| 供应商名称   | `Teio`                         |
| 接口类型    | `OpenAI` 或 `OpenAI Compatible` |
| API 地址  | `https://teio.me/v1`           |
| API Key | `你的 API 密钥`                    |
| 默认模型    | 从获取到的模型列表中选择                   |

## 支持的接口

Teio 当前支持以下接口。大多数客户端只需要填写 **Base URL** 和 **API Key**；只有自定义请求、高级客户端或 SDK 才需要填写完整路径。

| 接口类型                      | 适用场景                           | Method | Path                                     |
| ------------------------- | ------------------------------ | ------ | ---------------------------------------- |
| `openai`                  | OpenAI Chat Completions 兼容对话接口 | `POST` | `/v1/chat/completions`                   |
| `openai-response`         | OpenAI Responses 兼容接口          | `POST` | `/v1/responses`                          |
| `openai-response-compact` | Responses 会话压缩接口               | `POST` | `/v1/responses/compact`                  |
| `anthropic`               | Anthropic Messages 兼容接口        | `POST` | `/v1/messages`                           |
| `gemini`                  | Gemini `generateContent` 兼容接口  | `POST` | `/v1beta/models/{model}:generateContent` |
| `image-generation`        | OpenAI Images Generations 兼容接口 | `POST` | `/v1/images/generations`                 |
| `image-response`          | 通过 Responses 接口进行图片/多模态响应      | `POST` | `/v1/responses`                          |

<Tip>
  Gemini 接口中的 `{model}` 需要替换为实际模型 ID。Responses 与 Image Responses 使用同一个 `/v1/responses` 路径，区别主要取决于请求体和所选模型能力。
</Tip>

## 常见问题

<AccordionGroup>
  <Accordion title="获取模型列表失败或出现异常怎么办？">
    先登录 Teio 后台，检查当前 API 密钥是否已经设置分组。然后确认工具中填写的是完整 API Key，并且密钥分组与目标模型所属分组一致。最后检查接口类型和 URL 是否匹配，Base URL 可以尝试使用 `https://teio.me/v1`。
  </Accordion>

  <Accordion title="模型列表为空怎么办？">
    接口有返回但模型列表为空，通常表示没有选择分组，或所选分组没有可用模型。先登录 Teio 后台确认 API Key 已设置正确的分组，再检查 URL 是否多填或少填了路径。对于 Base URL 输入框，优先尝试 `https://teio.me/v1`；如果工具要求完整请求地址，再根据它使用 Chat Completions 或 Responses 地址。
  </Accordion>

  <Accordion title="提示 401 或 Invalid API Key 怎么办？">
    401 通常表示没有配置 API Key，或 API Key 无效。确认填写的是 [API 密钥](/create-token)，不是 Teio 后台的登录密码；检查密钥是否完整复制，并确认前后没有多余空格。也要确认当前接口类型与 API 密钥所属分组的协议相匹配。
  </Accordion>

  <Accordion title="接口返回 HTML 页面怎么办？">
    这通常表示请求地址不完整，可能是 Base URL 少了 `/v1`。优先填写 `https://teio.me/v1`；如果工具要求填写完整请求地址，再根据接口类型使用带 `/chat/completions` 或 `/responses` 的地址。
  </Accordion>

  <Accordion title="提示 model not found 怎么办？">
    当前默认模型不属于 API Key 对应的分组。查看 [模型与分组](/modelandgroup)，确认模型所属分组后，重新创建或更换对应分组的 API Key，再重新获取模型列表。
  </Accordion>
</AccordionGroup>