1. 注册并登录
先用你自己的账号登录后台，不建议借别人号直接开始。
余岂 AI 中转服务
完整接入文档
把客户第一次最容易卡住的地方，一次讲清楚。
这页不是简单的“说明”，而是按真正使用顺序重排后的完整接入文档。 先注册，再建 Key，再选客户端，再填 Base URL，再做短测。你不需要到处翻群消息，照着这页走就行。
第一次进来，先记这条最短路径。
不要一上来就研究全部功能。先把自己的账号、自己的 Key、自己的客户端跑通，体验最稳。
2. 创建测试 Key
单独新建一个令牌用于接入测试，后面核算消耗和排错都方便。
3. 先选一个客户端
Codex、Cherry Studio、Lobe Chat 这类工具，先跑通一个就够。
4. 做最小短测
先小样本成功，再慢慢加量。不要第一次就直接压大上下文。
你的 API Key：请使用你自己后台生成的 Key，不要混用别人发来的。
你的 Base URL：`https://api.yuqitoken.cn/v1`
第一次测试建议只做短请求，先确认返回、延迟和消耗都正常。
账号能登录，不代表客户端就能直接调模型。
真正决定能不能接入成功的，往往不是密码，而是你有没有用对 Key、分组和接口地址。
这张图对应的理解很简单：登录后台后，优先进入令牌管理，单独新建一个用于测试接入的 Key。 这样后面你改客户端配置、核对消耗、判断模型是否正常时，不会跟别的使用场景混在一起。
为什么建议单独建测试 Key
- 出问题时更容易判断是哪一端配置错了。
- 消耗核算更清楚，不会跟日常使用混在一起。
- 后面真要给客户演示，也可以单独控制额度。
第一次最常见的错误
- 把登录密码当成 API Key 用。
- 复制 Key 时带了空格或少了一截。
- 账号分组没开目标模型，就误以为“站挂了”。
不要把所有客户端都学一遍，先挑一个最顺手的。
大多数用户其实只会长期用 1 到 2 个客户端。第一次只要把最常用的那个接通，剩下的都只是复制参数。
Codex
适合改代码、跑命令、读项目结构、排错，偏工程执行型。
Cherry Studio
更适合普通桌面聊天、多模型切换和日常轻度使用。
Lobe Chat / OpenCat
前者适合网页型入口，后者适合移动端随手用，本质配置逻辑都差不多。
Cherry Studio 最适合新手先跑通第一条链路。
桌面端里它算是比较直观的。核心就三步：新增 OpenAI 兼容提供商、填你自己的 Key、填你自己的 Base URL。
步骤 1：新增提供商
打开 Cherry Studio 后，进入提供商或 API 配置页，新增一个 OpenAI 兼容提供商。
步骤 2：填你自己的 Key
API Key 只填你自己后台创建的 Key，不要填登录密码，也不要用别人转发给你的旧 Key。
步骤 3：填地址并短测
Base URL 填 `https://api.yuqitoken.cn/v1`，保存后先发一句短消息测试，不要第一次就压复杂任务。
Lobe Chat 适合网页型入口，参数也更清楚。
如果你不想装太多桌面客户端，Lobe Chat 这种网页型工具会更顺。配置逻辑和 Cherry Studio 本质一样。
步骤 1：先新增模型提供商
优先选 OpenAI 兼容接法，不要自己随便猜别的协议模式。
步骤 2：配置两项核心参数
API Key = 你自己后台生成的 Key；Base URL = `https://api.yuqitoken.cn/v1`。
步骤 3：先做短问答测试
先发一条短问题，看返回是否正常，再决定要不要接长上下文和高价模型。
移动端更适合随手用，但配置时更容易填错。
手机界面小，最容易把域名、Token、密码这三件事弄混，所以第一次一定要慢一点填。
步骤 1：服务器地址填你的 API 域名
按客户端要求填 `api.yuqitoken.cn` 或完整地址，不要把前台说明站域名填进去。
步骤 2：Token 填你自己的 Key
这里填的是令牌，不是后台登录密码。移动端最常见的错，就是把两者混用了。
步骤 3：保存后先发一句话
先用一句最短测试消息确认能返回，再考虑长期用和切模型。
真正接 Codex 时，最重要的是配置别填错。
Codex 这类工具一旦把 Base URL、provider、环境变量写顺，后面就会很顺；写错一项，就会反复报错。
最关键的三项
- 模型名：优先以后台实际开放模型名为准。
- Base URL：`https://api.yuqitoken.cn/v1`
- Key：建议通过环境变量读取，不要直接硬编码到项目里。
第一次建议这样测
- 先在空目录里做一个只读测试。
- 确认返回正常后，再进真实项目目录。
- 先别让它直接改生产代码。
Base URL = https://api.yuqitoken.cn/v1
API Key = 你自己后台创建的 Key
建议先做短测试，再决定长期使用如果你想看更细的 `config.toml`、环境变量和 `codex` 命令写法，直接看下面这页更完整： Codex 使用说明
先把最容易误判的几件事讲明白。
很多人第一反应是“模型不行”或“站不稳定”，但真实问题往往更基础。
为什么账号能登录，但客户端调不通？
先查是不是把密码当成了 Key，再查 Key 是否创建在正确分组里，最后再看模型名和 Base URL。
为什么感觉消耗不对？
先看是不是用了长上下文、高输出或高价模型。判断成本时，不要只盯一个表面数字。
为什么提示模型不存在？
优先以后台当前开放模型列表为准，不要自己猜模型名。
为什么接口返回格式异常？
大多数情况是地址没带 `/v1`、请求格式不兼容、或者客户端协议没对齐。