从连接开始，
让想法成为可能。
创建密钥、配置工具、开始使用。
这份指南陪你完成第一次接入。
在控制台创建 API 密钥
通过 CC Switch 管理配置
发送请求并检查调用记录
PREPARE
账号与 API 密钥
登录 YongAPI
打开 YongAPI 控制台 ↗，登录你的账号。若站点已开放注册，可按登录页提示创建账号。
确认可用服务
查看账号的余额或套餐，以及密钥可使用的分组与模型。模型权限取决于你当前的账号和分组，请以控制台实际显示为准。
创建并保存密钥
在控制台的 API 密钥管理页面创建密钥，并填写便于识别的名称，例如“我的工作电脑”。如果创建时需要选择分组或设置额度，请按使用需求选择。
完整密钥相当于调用凭证，请勿放入公开网页、代码仓库或聊天截图。如果已经泄露，请在控制台撤销旧密钥，并创建新密钥。
CONNECT
用 CC Switch 配置客户端
CC Switch 用于管理客户端的供应商配置。先选择你正在使用的客户端，再填写对应的服务地址、API 密钥和模型。
选择客户端，添加供应商
打开 CC Switch，选择目标客户端（例如 Codex、Claude Code 等），添加或编辑供应商，将名称填写为 YongAPI。
参考右侧填写配置
手机端配置示例在下方。粘贴你自己的 API 密钥，根据所选客户端填写请求地址，并选择密钥实际可用的模型。
保存并启用
保存供应商配置，切换为启用状态。按客户端要求重新加载配置或重启客户端，再开始使用。
根据下方客户端地址表填写
你在 YongAPI 创建的密钥
获取模型列表，或填写可用的模型 ID
选择客户端对应的地址
以下是常见的直连配置示例。使用相应协议和有调用权限的密钥；若启用了本地代理或使用其他预设，请遵循对应模式的配置说明。
https://api.szyurl.top/v1https://api.szyurl.top其他客户端请先确认所用协议及 Base URL 格式。模型名称请使用控制台或模型列表提供的完整 ID，API Key 必须有相应权限。
READY TO GO
检查你的第一次连接
先发送一条简短消息
在配置好的客户端新建会话，发送“你好，请简短介绍一下你能做什么”。成功收到回复后，再进行正式任务。
- 确认当前启用的是 YongAPI 供应商。
- 确认客户端已重新加载配置，所选模型在密钥权限范围内。
- 回到 YongAPI 控制台，查看是否出现对应的调用记录。
首次测试也可能产生正常的 API 用量。失败时先看错误详情，再对照下面的排查说明。
TROUBLESHOOTING
遇到问题，先看这里
状态码只是排查线索，请结合客户端的完整错误信息判断。
401：身份验证失败
检查 API 密钥是否复制完整、前后是否有空格，以及密钥是否已撤销或过期。确认填写的是 YongAPI 创建的调用密钥。
403：请求被拒绝
检查密钥分组、模型权限、账号状态及访问限制。具体拒绝原因以错误返回内容为准。
404：找不到接口或模型
核对客户端、协议、请求地址和模型 ID。Base URL 通常不应直接填写完整的业务接口路径；不要将不同客户端的地址格式混用。
429：限流或可用额度问题
降低并发、稍后再试，并查看账号余额、套餐及配额。具体是频率限制还是额度不足，请以错误详情为准。
连接超时，或者出现 5xx 错误
检查网络及客户端代理设置，稍后重试。若持续发生，保留出错时间、客户端名称、模型 ID 和脱敏后的错误信息，联系站点管理员排查。
保存了配置，客户端仍在使用旧供应商
确认新供应商已启用，而不只是保存。重新加载配置或完全退出并重启客户端；若存在其他环境变量、启动脚本或本地代理，也需检查它们是否覆盖了配置。
需要联系管理员时，应该提供哪些信息？
提供客户端及版本、出错时间、模型 ID、请求 ID（如果有）和错误截图。截图前隐藏 API 密钥、账号隐私和敏感对话内容。
准备好开始了吗？
打开控制台，创建你的第一把 API 密钥。