通用客户端接入

适用于所有支持自定义 OpenAI Base URL 的客户端 / SDK。通过这种方式接入，可调用所有公开模型（GPT、Claude、Gemini、Qwen、GLM、DeepSeek、Kimi 等）。

如果是 Claude Code CLI 或 Claude 官方桌面端，请走 Claude 系列客户端接入（基于 Anthropic 协议）。

如果是 Codex App / CLI / IDE 插件，请走 Codex 系列客户端接入（基于 Codex config.toml）。

通用配置参数

无论用哪个客户端，填的都是同一组：

字段	值
API Base URL	https://api.aiqizhilian.tech/v1
API Key	<你的 API Key>（联系 info@aiqizhilian.tech 获取）
鉴权头	Authorization: Bearer <API Key>
协议	OpenAI Chat Completions 兼容

注意 base URL 是否要带 /v1

• 多数客户端 / 官方 SDK：填 https://api.aiqizhilian.tech/v1
• 少数客户端只让填域名：填 https://api.aiqizhilian.tech，调用路径它会自己加 /v1

如果一开始填错，第一次调用通常会 404，把 /v1 加上或去掉再试一次即可。

SDK 接入

OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="<你的 API Key>",
    base_url="https://api.aiqizhilian.tech/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "hello"}],
    max_tokens=256,
)
print(resp.choices[0].message.content)

OpenAI Node.js SDK

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: 'https://api.aiqizhilian.tech/v1',
})

const resp = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: 'hello' }],
  max_tokens: 256,
})
console.log(resp.choices[0].message.content)

图形化客户端

下表汇总了已验证兼容的桌面 / 移动 / 网页客户端。配置项基本一致：填 Base URL、填 API Key、选模型。

客户端	平台	Base URL 字段	备注
Cherry Studio	macOS / Windows / Linux	https://api.aiqizhilian.tech/v1	OpenAI 自定义服务，鉴权选 Bearer
LobeChat（自部署 / Web）	Web	https://api.aiqizhilian.tech/v1	在「设置 → AI 服务商 → OpenAI」中配置
AI as Workspace	Web	https://api.aiqizhilian.tech/v1	OpenAI 类型
AMA 问天	iOS / macOS / Android	https://api.aiqizhilian.tech	仅填域名
OpenCat	iOS / macOS	https://api.aiqizhilian.tech	仅填域名
AionUI	macOS / Windows	https://api.aiqizhilian.tech/v1	OpenAI 自定义 provider
流畅阅读	浏览器扩展	https://api.aiqizhilian.tech/v1	翻译 / 朗读类场景
CC Switch	macOS	https://api.aiqizhilian.tech	API 调度器
Codex App / CLI / IDE	macOS / Windows / Linux	https://api.aiqizhilian.tech/v1	走 Codex 系列客户端接入

如需某个客户端的详细配置示例，可发送邮件到 info@aiqizhilian.tech 索取。

常见问题

客户端调通了，但模型选择器里看不到 Claude / Qwen / 其他模型

多数 OpenAI 客户端会调 /v1/models 自动发现模型清单。如果客户端只硬编码了 OpenAI 官方模型名，需要在客户端「自定义模型」里手动添加；模型 ID 与 Chat Completions 可用模型 一致。

调用 Claude 模型时返回特别慢 / 报错

请使用我们的 Chat Completions 接口调用 Claude（这是默认推荐路径，已实测各 Claude 系列可用）。如果你的客户端原生支持 Anthropic 协议（如 Claude Code），改走 Messages 通常更接近上游表现。

401 / 403

• 检查 API Key 拼写。
• 检查鉴权头是否是 Authorization: Bearer ...，不要用 x-api-key。
• 联系运营方确认 Key 是否仍有效。