首页 / 教程 / 客户端配置

手机上的 AI 客户端怎么接自建 API:iOS 与安卓配置要点

桌面端调好了,出门在外掏出手机,还是想让 AI 接着答。手机上接自建 API 本身并不复杂,麻烦都集中在小地方:地址少写一段、证书没放行、回答到一半切了后台。这几处提前捋清,手机端通常一次就能配好。

手机端和桌面端,差在哪三件事

第一是网络环境。桌面端往往和服务器在同一个网络里,写局域网地址就能用;手机一出门切到移动网络,那个地址立刻失效。要么统一用公网域名,要么接受「只在同一个 WiFi 下能用」这个前提,别等到路上才发现。

第二是系统的后台策略。手机为了省电会把切到后台的应用挂起,长回答经常断在半截。第三是输入:密钥动辄四五十位字符,手工敲几乎必错,粘贴之后还要回头看一眼首尾有没有带上多余的空格。

一句话记:地址要能在门外打开,密钥要粘贴不要手打,长回答别急着切走屏幕。

配置前先准备两样东西

接口地址填 https://api.aigcbreeze.cn/v1。多数客户端要求填到 /v1 这一层,只填域名会换来一个 404;也有客户端会自己补 /chat/completions,那就不要再手工加一遍,否则路径会重复成两段。

密钥在控制台创建后只完整显示一次,关掉页面就看不到了。建议按用途分开建、分别命名,哪天要停用只删那一个,其他设备不受影响。

地址和密钥别贴在群聊或公开仓库里;确实要发给别人,也发到能撤回的地方。

iOS 端怎么填

应用商店里的 AI 应用大概分两类:一类只能用它自家的服务,填不了自定义地址;另一类在设置里留了「自定义 API」或「Base URL」的入口。装之前先确认有这一项,免得装完才发现用不上。

进入设置,把地址、密钥、模型名三项填上。模型名要和模型列表里显示的一致,写错时通常报的是「找不到模型」,而不是密钥错误——这个报错刚好能帮你判断是哪一项出的问题。

首次请求时,系统可能弹出「允许访问本地网络」或证书确认,选允许。如果某个客户端只给了一个输入框、没有高级选项,一般也能用「地址加密钥」跑通,只是切换模型会受限。

安卓端怎么填

安卓的选择更多,开源客户端大多支持自定义地址。如果安装包来自商店之外,需要临时打开「安装未知应用」的开关,装完再关掉就行。

填完地址还有一步常被忽略:把这个应用加入电池优化白名单,或者允许后台活动。不加的话,回答生成到一半切走屏幕,回来往往只剩半句。

另外留意代理。开着代理或 VPN 时请求出口和平时不一样,某些地址会连不上;排查时先把代理关掉再试一次,能省下很多来回。

常见问题

一直转圈,或者提示网络错误

按顺序查三处:地址有没有带 /v1、是不是 https、手机浏览器能不能打开 https://api.aigcbreeze.cn。浏览器也打不开,问题就在网络或域名,跟客户端无关。

提示 401 或 403

基本都是密钥的问题:复制时带进了空格、密钥被删除或停用、或者误填了别家的密钥。重新复制一次,必要时新建一个再试。

能聊天但传图失败

两种可能:当前模型不支持图片输入,或者图片太大超过了客户端的上限。换一个支持视觉的模型,或者先把图片压小再发。

把手机也变成入口

配好这一台,后面换设备就是重复同样三步:地址、密钥、模型名。把这几个值存进密码管理器,换手机时不用再翻一遍控制台。

留言交流

有问题、有补充,写两句吧~留言会实时显示在下方(无需注册)。

留言加载中…
← 上一篇:客户端里切换模型的讲究:什么时候换、换哪个 下一篇:编码工具接入 API 站 →