艾维 API 接入教程

手机和电脑都能接。照着做,五分钟搞定。

电脑 · Windows 手机 · 苹果 / 安卓

0先记住这三个

不管用哪个软件,要填的都是这三样:

填什么内容
接口地址https://www.aivkey.com/v1
API 密钥sk- 开头,在控制台创建
模型名称从控制台「模型广场」复制
地址结尾的 /v1 要带上。第一次连不上,先把带 /v1 和不带 /v1 各试一次,八成的 404 都出在这儿。

1注册账号,拿密钥

  1. 打开 www.aivkey.com 注册账号
  2. 去邮箱点验证链接。收不到就翻一下垃圾箱
  3. 登录后左侧菜单进「密钥」,新建一个,名字写清是哪台设备
  4. 复制生成的 sk- 开头那串

顺手打开一次「模型广场」,后面填模型名要用。

2电脑端(Windows + Codex)

配置前先做一件事:右下角托盘里把 Codex 完全退出,同时关掉 ccs、C++ 之类的配置工具。它们会和你抢同一份配置文件,不关掉配置会被覆盖回去。

下载配置工具,右击链接选「另存为」:

ZIP 艾维Codex配置工具.zip Windows · 约 35 KB · 解压后双击 exe
  1. 解压整个文件夹,不要只把 exe 拿出来——旁边的文件缺一个就打不开
  2. 双击 AIJuheConfigTool-Custom.exe
  3. 「接口地址」已经锁好了,不用管
  4. 把你的 sk- 密钥粘进「密钥」那一栏
  5. 先点「测试连接」,日志里看到 /models 返回 200 就说明通了
  6. 再点「检测并配置Codex」,工具会自己写好配置并启动 Codex

以后启动就直接用,不用再配。充值之后也不用重启 Codex,接着发消息就行。

模型怎么选

优先用 gpt-5.6-terra 和 gpt-5.6-luna,日常够用还便宜。gpt-5.6-sol 是主力,遇到难问题再切过去。想换模型,点工具里的「获取模型」把你密钥能用的全拉出来挑。

出问题了

现象怎么办
连不上、一直转圈点工具里的「修复网络」,清掉代理残留和 DNS 缓存
报 401密钥不对,回控制台重新复制
报 model not found模型名写错,或你的密钥分组不含这个模型,用「获取模型」拉一次
配置改坏了原文件自动备份在 %USERPROFILE%\.codex\backups\

3手机端(苹果 / 安卓)

手机上没有 Codex,用聊天客户端接,效果一样。

苹果:装 Chatbox

iOS Chatbox AIApp Store 免费 · 认准开发者 2.5 HK LIMITED

安卓:装 Chatbox

APK 官方下载页chatboxai.app · Google Play 国内打不开

填三行

  1. 打开 App → 设置 → 模型提供方
  2. 选「OpenAI API」或「添加自定义提供方」
  3. 接口地址填下面这个:
https://www.aivkey.com/v1
  1. API Key 粘贴你的 sk- 密钥
  2. 模型填 gpt-5.6-sol
  3. 保存,发一句「你好」测试
不要用服务器 IP 地址。IP 走的是明文 http,安卓 9 以上系统会直接拦,很多客户端连不上还看不出原因。统一用 https://www.aivkey.com/v1。
ChatGPT、Claude 官方 App 用不了——它们只能连官方服务器,不允许改接口地址。这是设计限制,没有绕过办法。

4确认真的通了

电脑上打开 PowerShell,粘这一行执行:

curl -H "Authorization: Bearer sk-你的密钥" https://www.aivkey.com/v1/models

返回一串模型列表就是通了。返回 API_KEY_REQUIRED 说明密钥没送出去,检查有没有多余空格。

这个命令是排查一切问题的起点:它能通,问题就在客户端设置;它不通,就是地址或密钥的问题。

5想验证模型是不是真货

本站已经部署了在线检测工具,直接开网页就能跑。计算在你自己的浏览器里完成,密钥不出本机。

→ 打开模型检测工具

另有 meow-llm-detector 的官方下载与在线版入口,一并整理在同一个页面里。

6搞不定就来找我们

Q 群:515907887

遇到问题把报错原文截图发群里,比描述现象有用得多。充值、分组、模型相关的问题也在这里问。