客户端与接口地址
地址怎么填
| 客户端协议 | Base URL | 完整请求地址 |
|---|---|---|
| OpenAI Chat Completions | https://api.peroai.cc/v1 |
https://api.peroai.cc/v1/chat/completions |
| OpenAI Responses | https://api.peroai.cc/v1 |
https://api.peroai.cc/v1/responses |
| Anthropic Messages | https://api.peroai.cc |
https://api.peroai.cc/v1/messages |
| 生图 | https://api.peroai.cc/v1 |
https://api.peroai.cc/v1/images/generations |
| 视频 | https://api.peroai.cc/v1 |
https://api.peroai.cc/v1/videos |
Base URL 和完整请求地址是两个不同的字段。 客户端会自己补上接口路径时填 Base URL;只有客户端明确要求填完整 Endpoint 时,才填右边一列。
如果客户端会自动追加 /v1,地址只填 https://api.peroai.cc。看到 /v1/v1/...、/responses/responses 这类重复路径,说明地址填多了,改地址即可,不用换密钥。
各分组支持的协议
| 分组 | Chat Completions | Responses | Anthropic Messages |
|---|---|---|---|
GPT(gpt-pro、gpt-promax、gpt-test) |
✓ | ✓ | |
Claude(claude-kiro) |
✓ | ✓ | |
Claude(claude-ccmax) |
仅限 Claude Code 客户端 | 仅限 Claude Code 客户端 | |
grok-ultra、gemini-ultra |
✓ | ||
image-all |
见生图与视频 |
聊天客户端
以 Cherry Studio 为例,其它客户端大同小异:
- 新增服务商,类型选「OpenAI」(调 Claude 也可以选「Anthropic」,地址按上表填)。
- API 地址填
https://api.peroai.cc(Cherry Studio 会自己补/v1),API 密钥填本站密钥。 - 添加模型,粘贴模型广场里的完整模型 ID。不要填分组名或模型昵称。
- 保存后发一条短消息,再到「使用日志」确认有这次记录。
客户端的「获取模型列表」只说明密钥有效,不等于调用成功。列表拉不下来时可以手动填模型 ID,以实际发消息的结果为准。
一键填入
在「API 密钥」里,点某把密钥的「聊天」菜单,可以直接打开下列客户端并自动填好地址和密钥:Cherry Studio、AionUI、DeepChat、AQBot、Lobe Chat、AI as Workspace、AMA 问天、OpenCat、流畅阅读。电脑上需要先装好对应客户端。
编程助手
- Codex 接入教程:桌面版、CLI 和 VS Code / Cursor / Windsurf 扩展,使用 Responses 协议。
- Claude Code:使用 Anthropic Messages 协议和 Claude 分组。
- CC Switch 一键导入:一次导入 Claude Code 或 Codex 配置。
- 自己写程序:API 调用示例。
图片输入、工具调用、长上下文等能力取决于模型、分组和客户端。先用一条纯文字请求确认连通,再逐项打开需要的功能。
最常见的三个配置错误
- 把
peroai.cc填成了 API 地址。 那是控制台,调用地址是api.peroai.cc。用peroai.cc/v1会收到「API 地址已改为 https://api.peroai.cc」的 404 提示。 - 密钥和模型不在同一个分组。 报错「分组 xxx 下模型 yyy 无可用渠道」就是这个原因。换一个属于该分组的模型,或者换一把对应分组的密钥。
- 协议和路径对不上。 按上面的表检查,不要随意在地址后面加接口路径。