文档 / 接入指南

客户端与接口地址

地址怎么填

客户端协议 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 为例,其它客户端大同小异:

  1. 新增服务商,类型选「OpenAI」(调 Claude 也可以选「Anthropic」,地址按上表填)。
  2. API 地址填 https://api.peroai.cc(Cherry Studio 会自己补 /v1),API 密钥填本站密钥。
  3. 添加模型,粘贴模型广场里的完整模型 ID。不要填分组名或模型昵称。
  4. 保存后发一条短消息,再到「使用日志」确认有这次记录。

客户端的「获取模型列表」只说明密钥有效,不等于调用成功。列表拉不下来时可以手动填模型 ID,以实际发消息的结果为准。

一键填入

在「API 密钥」里,点某把密钥的「聊天」菜单,可以直接打开下列客户端并自动填好地址和密钥:Cherry Studio、AionUI、DeepChat、AQBot、Lobe Chat、AI as Workspace、AMA 问天、OpenCat、流畅阅读。电脑上需要先装好对应客户端。

编程助手

图片输入、工具调用、长上下文等能力取决于模型、分组和客户端。先用一条纯文字请求确认连通,再逐项打开需要的功能。

最常见的三个配置错误

  1. 把 peroai.cc 填成了 API 地址。 那是控制台,调用地址是 api.peroai.cc。用 peroai.cc/v1 会收到「API 地址已改为 https://api.peroai.cc」的 404 提示。
  2. 密钥和模型不在同一个分组。 报错「分组 xxx 下模型 yyy 无可用渠道」就是这个原因。换一个属于该分组的模型,或者换一把对应分组的密钥。
  3. 协议和路径对不上。 按上面的表检查,不要随意在地址后面加接口路径。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。