介绍

填写正确的 API 地址 ​

在聊天软件或编程工具中连接爱次元时,通常需要填写 API 地址、API Key 和模型名称。API 地址告诉软件去哪里连接服务,API Key 则用来验证你的账号权限。 两项分别填写,不要把密钥接在地址后面。

不同软件对地址栏的叫法不一样,你可能会看到“API 地址”“API Host”“基础地址”或“Base URL”。找到对应输入框后,先从下面选一条线路,再按软件要求填写。

可用线路 ​

线路类型推荐说明API 地址
境内顶级线路大陆推荐https://api.acy7.com
境内顶级线路境内推荐https://api.acy7.cc
全球智能优化AI 优选路由https://gptg.cc
全球智能优化AI 优选路由https://aicy.pro
国模专用线路仅限 Kimi、GLM 模型调用https://cn.6mq.cn
澳大利亚线路延迟一般https://acy7.pro
香港线路延迟一般https://acy7.xyz

在中国大陆使用,可以先选 https://api.acy7.com。 如果连接超时或使用不稳定,再试 https://api.acy7.cc,也可以尝试全球智能优化线路。实际速度会受你所在地区和网络影响,选一条能稳定使用的即可,不用每次都换。

如果软件要求填写基础地址,可单独复制这个完整值:

text
https://api.acy7.com

https://cn.6mq.cn 只用于 Kimi、GLM 模型,使用其他模型时请选择其他线路。选了这条线路,也仍需确认自己的密钥分组有对应模型的使用权限。

地址后面要不要加 /v1 ​

上表列出的是线路的基础地址。有些软件会自动补上接口路径,有些需要你在地址末尾加上 /v1,因此同一条线路在不同软件中的填写方式可能不同。

以第一条线路为例:

软件教程的要求应填写的地址
填写基础地址,软件自动补齐路径https://api.acy7.com
地址末尾需要带 /v1https://api.acy7.com/v1

/v1 是接口路径的一部分,不是另一条线路。按你所用软件的教程填写,不要遇到报错就反复添加。 如果设置页能预览最终请求地址,留意是否出现了 /v1/v1;这通常说明软件已经自动补了一次。

只有对应软件的教程明确要求 /v1 时,才复制这个值:

text
https://api.acy7.com/v1

如果看到“完整 URL”或单独的“API 路径”选项,先按对应教程设置,不要自行把 /chat/completions、/responses 或 /messages 接到地址后面。这些是具体接口的路径,填错位置也会导致连接失败。

可以从聊天客户端教程或编程工具教程找到所用软件的配置说明。

填好后怎么确认 ​

  1. 将选好的地址粘贴到软件的 API 地址栏,检查开头的 https:// 是否完整,前后有没有多余空格。
  2. 按该软件的教程确认是否需要 /v1,然后在 API Key 栏粘贴已创建的密钥。
  3. 选择密钥分组支持的模型,保存设置,发送一句简短的话,例如“你好”。

收到正常回复,说明这次连接已经成功。也可以打开使用日志,核对刚才的请求和用量。

这里要填的是上表中的 API 线路地址。浏览器里打开的文档网址,以及带有登录页、控制台页面路径的网址,都不要直接复制到这个输入框中。

连不上时先看报错 ​

遇到的情况先检查什么
连接超时、一直没有回复检查网络,再换一条适用线路试试;更换时保留软件要求的 /v1 等填写格式
404、接口不存在检查地址有没有拼错、/v1 有没有重复,以及软件选择的接口类型是否符合教程
401、密钥无效重新复制 API Key,检查是否漏了字符,或密钥已被停用、过期
提示模型不可用或没有权限核对模型名称、密钥分组,以及所选线路是否支持该模型

换线路主要用于排查连接问题。如果提示的是密钥或模型权限错误,先处理对应设置。仍然无法解决时,可以联系客服,提供所用软件、线路地址和报错截图;截图中的完整密钥记得遮住。

阅读中遇到问题?联系支持
AI 助手