其他客户端

你要用的软件不在前面几页里？大多数支持自定义接口的客户端都能接我们，配置逻辑是一样的。

这一页给你通用方法。

先看它支不支持

客户端必须满足两个条件：

能填自定义 Base URL（有的叫"接口地址""API 域名""API Host""自定义服务地址"）
能填 API Key

能填这两个，基本就能接。 如果客户端只让你登录它自己的账号（比如原版 ChatGPT 客户端），那就没法接。

通用的四步

不管什么软件，流程都一样：

① 找「自定义服务商 / 添加提供方 / OpenAI 兼容」这类入口
       ↓
② 接口类型选 OpenAI 兼容（OpenAI Compatible）
       ↓
③ 填 Base URL 和 API Key
       ↓
④ 手动添加模型 ID（比如 grok-4.6）

90% 的失败都出在第 ③ 步的 Base URL 上。

⚠️ Base URL 到底带不带 `/v1`

这是最坑的地方——不同软件要求不一样，没有规律。

已知的对照（照抄即可）：

软件	Base URL
Claude Code	`https://api.wxiai.com`
Cherry Studio	`https://api.wxiai.com`
ChatGPT-Next-Web	`https://api.wxiai.com`
Codex CLI	`https://api.wxiai.com/v1`
Cursor	`https://api.wxiai.com/v1`
RooCode / KiloCode	`https://api.wxiai.com/v1`
Continue.dev	`https://api.wxiai.com/v1`
Chatbox	`https://api.wxiai.com/v1`
LobeChat	`https://api.wxiai.com/v1`
Open WebUI	`https://api.wxiai.com/v1`

完整速查表 → Base URL 怎么填

你的软件不在表里？ 用这个方法判断：

看报错里拼出来的路径是什么。
报错里出现说明怎么改
/v1/v1/chat/completions 多填了 /v1 去掉，只留域名
/chat/completions（没有 v1）少填了 /v1 补上
先填带 /v1 的试，报 /v1/v1 就去掉——最多两次就能试对。

报错里出现	说明	怎么改
`/v1/v1/chat/completions`	多填了 `/v1`	去掉，只留域名
`/chat/completions`（没有 v1）	少填了 `/v1`	补上

关键原则：别把路径写进域名里

永远不要填完整的接口地址，比如 https://api.wxiai.com/v1/chat/completions。

Base URL 是"根"，客户端会在后面接路径。你填了完整地址，等于让它接两次。

模型 ID 要手动加

绝大多数客户端不会自动把所有模型列出来，需要你手动输入模型 ID。

模型名以 GET /v1/models 为准，别凭记忆写：

bash

curl https://api.wxiai.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

如果客户端支持 Anthropic 或 Gemini 协议

有些客户端（比如 Claude Code）只认 Anthropic 协议，有些只认 Gemini 协议。我们也支持，但 Base URL 的填法不一样：

协议	Base URL
OpenAI	`https://api.wxiai.com/v1`
Anthropic	`https://api.wxiai.com`（不带 `/v1`）
Gemini	`https://api.wxiai.com`

我们支持的协议

万一客户端要你选协议，按这个表对照：

协议	端点
OpenAI Chat Completions	`POST /v1/chat/completions`
OpenAI Responses	`POST /v1/responses`
Anthropic Messages	`POST /v1/messages`
Gemini 原生	`POST /v1beta/models/{model}:generateContent`
文本转语音	`POST /v1/audio/speech`
语音转文本	`POST /v1/audio/transcriptions`
图像生成	`POST /v1/images/generations`
实时语音	`WSS /v1/realtime`

我们不做：Embeddings（Grok 官方没有）、Rerank、Moderation。

出了问题的通用排查法

第一步：先用命令行确认 Key 和地址没问题

bash

curl https://api.wxiai.com/v1/models \
  -H "Authorization: Bearer sk-你的APIKey"

能返回模型列表 → Key 和地址都对，问题在客户端配置上。报错 → 先解决这里，配客户端也没用。

第二步：看我们的调用日志

去 https://api.wxiai.com 看有没有请求记录：

有记录 → 请求到了我们这，看我们的错误信息
没记录 → 请求根本没发出去，是客户端侧的问题（多半是 Base URL）

这两步能把问题范围缩小一半以上。

常见报错

现象	原因	怎么办
`404`	Base URL 拼错	见上面的报错对照表
`401`	Key 不对	重新复制，别带空格
模型列表是空的	客户端不会自动加载	手动输入模型 ID
回复内容是空的	少了 `/v1`	补上试试
找不到填地址的地方	客户端不支持自定义	换一个，或看软件示例里已支持的

先看它支不支持 ​

通用的四步 ​

⚠️ Base URL 到底带不带 /v1 ​

关键原则：别把路径写进域名里 ​

模型 ID 要手动加 ​

如果客户端支持 Anthropic 或 Gemini 协议 ​

我们支持的协议 ​

出了问题的通用排查法 ​

常见报错 ​

相关页 ​