OpenAI 兼容应用

本页适用于明确支持 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 流式输出

不适用本页的工具

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

常见客户端速查

应用	配置位置	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 示例

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 里按需加：

    useResponsesApi: false

如果目标是 Codex CLI 或需要原生 Responses 行为，不要用这个开关，改用 Codex CLI 配置。

Aider 示例

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 令牌和模型是否可用：

curl https://api.aiohub.org/v1/models \
  -H "Authorization: Bearer sk-你的API令牌"

再验证普通 Chat Completions：

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 路径，或是否把请求强制发送到了不支持的端点。

常见问题

404 或路径不存在

Base URL 通常填 https://api.aiohub.org/v1，不要填完整端点。如果报错里出现 /v1/v1 或 /chat/completions/chat/completions，说明客户端配置里多填了一段路径。

模型不存在

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

工具调用或函数调用异常

通用 OpenAI 兼容客户端通常走 Chat Completions。确认所选模型、分组和客户端都支持 tool/function calling；否则先用普通消息验证。

Codex 模型在普通客户端失败

Codex CLI 推荐使用 Responses API。普通 OpenAI 兼容客户端如果只支持 /chat/completions，可能无法完整支持 Codex 模型能力。

选择客户端

AI 编程工具

图片客户端

聊天客户端

OpenAI 兼容应用

推荐配置

不适用本页的工具

常见客户端速查

Continue 示例

Aider 示例

curl 验证

常见问题

官方配置参考

​推荐配置

​不适用本页的工具

​常见客户端速查

​Continue 示例

​Aider 示例

​curl 验证

​常见问题

​官方配置参考

推荐配置

不适用本页的工具

常见客户端速查

Continue 示例

Aider 示例

curl 验证

常见问题

官方配置参考