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

​
推荐配置

配置项值说明
API Keysk-你的API令牌填入 AIOHub API 令牌
Base URLhttps://api.aiohub.org/v1OpenAI 兼容客户端使用带 /v1 的地址
Model控制台中可用的模型名例如 gpt-4o 或你的分组可用 Chat 模型
Streaming开启大多数编辑器插件和聊天客户端都支持 SSE 流式输出
不要把 Base URL 写成 https://api.aiohub.org/v1/chat/completions。客户端会自己追加 /chat/completions、/responses 或其它路径。

​
不适用本页的工具

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

​
常见客户端速查

应用配置位置ProviderBase URL备注
ClineVS Code 侧边栏设置OpenAI Compatiblehttps://api.aiohub.org/v1Cline 内置 prompt 较大，Token 用量可能偏高
Continue~/.continue/config.yamlopenaiapiBase: https://api.aiohub.org/v1GPT-5 / o-series 可能默认走 Responses API
Aider环境变量或 .aider.conf.ymlOpenAI compatibleOPENAI_API_BASE=https://api.aiohub.org/v1同时设置 OPENAI_API_KEY
Cursor模型设置Override OpenAI Base URLhttps://api.aiohub.org/v1手动输入模型名；先用基础 Chat 模型验证
Open WebUI管理员设置OpenAI APIhttps://api.aiohub.org/v1适合团队共享网关配置
LibreChatlibrechat.yamlcustom endpointbaseURL: 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 路径，或是否把请求强制发送到了不支持的端点。

​
常见问题

Base URL 通常填 https://api.aiohub.org/v1，不要填完整端点。如果报错里出现 /v1/v1 或 /chat/completions/chat/completions，说明客户端配置里多填了一段路径。
先请求 /v1/models 或查看控制台模型列表。分组决定可见模型；客户端本地预置模型列表不一定等于 AIOHub 当前可用模型。
通用 OpenAI 兼容客户端通常走 Chat Completions。确认所选模型、分组和客户端都支持 tool/function calling；否则先用普通消息验证。
Codex CLI 推荐使用 Responses API。普通 OpenAI 兼容客户端如果只支持 /chat/completions，可能无法完整支持 Codex 模型能力。

​
官方配置参考