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

# OpenAI 兼容应用

> 把 AIOHub 接入 Cline、Continue、Aider、Cursor、Open WebUI、LibreChat 等支持自定义 OpenAI Base URL 的应用。

本页适用于明确支持 OpenAI-compatible、OpenAI API compatible、Custom OpenAI Endpoint 或 Override OpenAI Base URL 的应用。多数应用只需要三项配置：AIOHub API 令牌、OpenAI 兼容 Base URL、模型名。

## 推荐配置

| 配置项       | 值                           | 说明                          |
| --------- | --------------------------- | --------------------------- |
| API Key   | `sk-你的API令牌`                | 填入 AIOHub API 令牌            |
| Base URL  | `https://api.aiohub.org/v1` | OpenAI 兼容客户端使用带 `/v1` 的地址   |
| Model     | 控制台中可用的模型名                  | 例如 `gpt-4o` 或你的分组可用 Chat 模型 |
| Streaming | 开启                          | 大多数编辑器插件和聊天客户端都支持 SSE 流式输出  |

<Note>不要把 Base URL 写成 `https://api.aiohub.org/v1/chat/completions`。客户端会自己追加 `/chat/completions`、`/responses` 或其它路径。</Note>

## 不适用本页的工具

如果客户端要求 Anthropic、Claude Messages、Gemini 或 Responses 配置，请使用对应专页：

* [Claude Code](/cn/clients/claude-code)
* [Codex CLI](/cn/clients/codex)
* [OpenCode](/cn/clients/opencode)
* [Gemini CLI](/cn/clients/gemini-cli)
* [Cherry Studio](/cn/clients/cherry-studio)
* [LobeHub](/cn/clients/lobehub)

## 常见客户端速查

| 应用         | 配置位置                      | Provider                 | Base URL                                    | 备注                                   |
| ---------- | ------------------------- | ------------------------ | ------------------------------------------- | ------------------------------------ |
| Cline      | VS Code 侧边栏设置             | OpenAI Compatible        | `https://api.aiohub.org/v1`                 | Cline 内置 prompt 较大，Token 用量可能偏高      |
| Continue   | `~/.continue/config.yaml` | `openai`                 | `apiBase: https://api.aiohub.org/v1`        | GPT-5 / o-series 可能默认走 Responses API |
| Aider      | 环境变量或 `.aider.conf.yml`   | OpenAI compatible        | `OPENAI_API_BASE=https://api.aiohub.org/v1` | 同时设置 `OPENAI_API_KEY`                |
| Cursor     | 模型设置                      | Override OpenAI Base URL | `https://api.aiohub.org/v1`                 | 手动输入模型名；先用基础 Chat 模型验证               |
| Open WebUI | 管理员设置                     | OpenAI API               | `https://api.aiohub.org/v1`                 | 适合团队共享网关配置                           |
| LibreChat  | `librechat.yaml`          | custom endpoint          | `baseURL: https://api.aiohub.org/v1`        | 把 API 令牌放到环境变量或 secrets              |

## Continue 示例

```yaml theme={"system"}
name: AIOHub
version: 0.0.1
schema: v1

models:
  - name: AIOHub GPT
    provider: openai
    model: gpt-4o
    apiBase: https://api.aiohub.org/v1
    apiKey: sk-你的API令牌
```

对于会自动使用 Responses API 的模型，如果客户端报错并且你只想走 Chat Completions，可以在 Continue 里按需加：

```yaml theme={"system"}
    useResponsesApi: false
```

如果目标是 Codex CLI 或需要原生 Responses 行为，不要用这个开关，改用 [Codex CLI 配置](/cn/clients/codex)。

## Aider 示例

```bash theme={"system"}
export OPENAI_API_BASE="https://api.aiohub.org/v1"
export OPENAI_API_KEY="sk-你的API令牌"
aider --model gpt-4o
```

也可以写入 `.aider.conf.yml`，避免每次在 shell 中导出变量。

## curl 验证

先验证 API 令牌和模型是否可用：

```bash theme={"system"}
curl https://api.aiohub.org/v1/models \
  -H "Authorization: Bearer sk-你的API令牌"
```

再验证普通 Chat Completions：

```bash theme={"system"}
curl https://api.aiohub.org/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello from AIOHub"}]
  }'
```

这两个请求成功后，客户端仍失败，优先检查客户端是否重复拼接了 Base URL 路径，或是否把请求强制发送到了不支持的端点。

## 常见问题

<AccordionGroup>
  <Accordion title="404 或路径不存在">
    Base URL 通常填 `https://api.aiohub.org/v1`，不要填完整端点。如果报错里出现 `/v1/v1` 或 `/chat/completions/chat/completions`，说明客户端配置里多填了一段路径。
  </Accordion>

  <Accordion title="模型不存在">
    先请求 `/v1/models` 或查看控制台模型列表。分组决定可见模型；客户端本地预置模型列表不一定等于 AIOHub 当前可用模型。
  </Accordion>

  <Accordion title="工具调用或函数调用异常">
    通用 OpenAI 兼容客户端通常走 Chat Completions。确认所选模型、分组和客户端都支持 tool/function calling；否则先用普通消息验证。
  </Accordion>

  <Accordion title="Codex 模型在普通客户端失败">
    Codex CLI 推荐使用 Responses API。普通 OpenAI 兼容客户端如果只支持 `/chat/completions`，可能无法完整支持 Codex 模型能力。
  </Accordion>
</AccordionGroup>

## 官方配置参考

* [Cline OpenAI Compatible](https://docs.cline.bot/provider-config/openai-compatible)
* [Continue OpenAI provider](https://docs.continue.dev/customize/model-providers/top-level/openai)
* [Aider OpenAI-compatible APIs](https://aider.chat/docs/llms/openai-compat.html)