教程
    • 余烬API 中转站使用指南
    • 余烬API · 令牌分组说明文档
    • AI 模型完整参数对比表
    • 主流大模型 API 价格对比表
    • 无限画布操作手册
    • 画布快捷键
    • CC Switch 使用教程

    余烬API 中转站使用指南

    站点地址：https://api.yujingai.top
    平台底座：New API · 支持 GPT/ Claude / Gemini 等多种模型统一接入（具体模型可去顶部导航栏模型广场参考）

    📋 目录#

    1.
    注册与登录
    2.
    充值与额度
    3.
    创建 API Key
    4.
    接入配置
    5.
    常见工具接入教程
    6.
    查看用量与日志
    7.
    常见问题 FAQ
    8.
    联系我们

    一、注册与登录#

    1. 注册账号#

    1.
    打开站点 https://api.yujingai.top
    2.
    点击右上角 「注册」
    3.
    填写邮箱 / 用户名和密码，完成注册
    4.
    支持邮箱/账号登录
    💡 建议使用常用邮箱注册，方便后续找回账号。

    二、充值与额度#

    充值方式#

    image.png
    登录后点击顶部导航 卡密商城→购买兑换码充值** 或进入钱包管理直接充值**

    💰 充值汇率#

    支付金额（人民币）获得额度（美元）说明
    请以站内显示为准—实际汇率以充值页面为准
    ⚠️ 额度以美元（$） 计价，模型按调用量扣除，不同模型价格不同，请在 「模型广场」 查看具体定价。基本上一美元的token额度只需要付小几毛钱的人名币。

    查看余额#

    进入 「钱包管理」 即可查看当前余额。

    三、创建 API Key#

    这是使用本站最核心的一步。API Key 是你调用模型的凭证，请妥善保存，不要泄露给他人。

    步骤#

    1.
    登录后，点击左侧导航 「令牌管理」
    2.
    点击左上角 「添加令牌」
    3.
    填写令牌名称（便于自己识别）
    4.
    去 模型广场 查看自己要调用模型的令牌分组并填入（令牌分组介绍）
    5.
    可选：设置额度限制和过期时间（不填则不限制，一般不用管）
    6.
    点击 「提交」，复制生成的 Key
    sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    ✅ Key 只会显示一次，请立即复制保存到安全的地方！
    ✅ 可以创建多个 Key，分别用于不同的工具或项目，方便管理和追踪用量。

    四、接入配置#

    所有工具接入时，填写以下两项：
    配置项填写内容
    API Base URL（接口地址）https://api.yujingai.top
    API Key你在「令牌管理」页面创建的 Key（sk-xxx...）
    本站兼容 OpenAI 格式，所有支持自定义 API 地址的工具均可接入。

    五、常见工具接入教程#

    🖥️ ChatBox#

    1.
    下载并打开 ChatBox
    2.
    点击左下角 「设置」
    3.
    选择模型提供方
    4.
    填写：
    API Host：https://api.yujingai.top
    API Key：你的 Key

    ✏️ cursor（AI 编程 IDE）#

    1.
    打开 Cursor，进入 File → Preferences → Cursor Settings
    2.
    找到 Models 选项卡
    3.
    点击 + Add Model，填入你需要的模型名（如 gpt-4o、claude-sonnet-4-6）
    4.
    找到 OpenAI API Key 一栏：
    API Key：填入你的 Key
    Base URL（Override）：https://api.yujingai.top/v1
    5.
    保存，选择刚添加的模型即可

    🤖 Claude Code（终端）#

    1.
    在终端中设置环境变量：
    2.
    永久生效（写入 ~/.zshrc 或 ~/.bashrc）：
    3.
    运行 claude 即可使用

    🔧 Python / 代码调用#

    📡 HTTP 直接调用（curl）#

    六、查看用量与日志#

    登录后进入 「使用日志」 页面，可以看到：
    每次请求的模型名称、时间、消耗 token 数
    每次请求扣费金额
    按日期筛选历史记录
    💡 建议为不同项目创建不同的 Token，这样日志中可以清楚区分每个项目的用量。

    七、常见问题 FAQ#

    🔐 权限 & 认证类#

    Q：提示 401 Unauthorized，怎么办？
    API Key 填写有误、已过期或被删除。请前往「令牌管理」确认 Key 是否有效，或重新创建一个新的 Key。同时检查 Key 前后是否有多余的空格。
    Q：提示 403 Forbidden？
    当前 Key 没有权限访问该模型。可能原因：
    创建令牌时选择的分组不包含该模型
    该模型需要更高权限的分组
    解决方法：回到「令牌管理」，确认令牌所属分组，或重新创建一个包含目标模型的分组令牌。

    💰 额度 & 计费类#

    Q：提示 402 Payment Required 或余额不足？
    账户余额已用尽，请前往「卡密商城」购买兑换码或「钱包管理」直接充值后继续使用。
    Q：明明有余额，还是报 402？
    可能是令牌本身设置了额度上限，而不是账户余额不足。前往「令牌管理」，检查该令牌的「额度限制」是否已耗尽，可以编辑令牌提高额度或设为不限制。

    🚦 请求限制类#

    Q：提示 429 Too Many Requests？
    请求频率过高触发限速，稍等 5~10 秒后重试。如果频繁遇到，建议：
    切换到并发限制更宽松的模型
    在代码中加入请求间隔（如每次请求间隔 1 秒）
    避免同时开多个工具调用同一个 Key
    Q：提示 413 Request Entity Too Large？
    单次请求体积过大，通常是上传了过大的文件或图片。请压缩图片后重试，或改用文字描述代替图片。

    ⚠️ 请求内容类#

    Q：提示 400 Bad Request 或 context_length_exceeded？
    输入的内容超过了该模型的最大上下文长度限制。解决方法：
    开新对话，清空历史上下文
    在客户端设置里限制历史消息条数（保留最近 10~20 条）
    使用 /compact 命令（Claude Code / Codex 等编程工具支持）让 AI 自动压缩上下文
    换用支持更大上下文的模型（如从 32K 换到 128K 或 1M）
    Q：提示 422 Unprocessable Entity？
    请求格式正确但内容有问题，服务器看懂了但无法处理。常见原因：
    模型名称拼写错误或填了不存在的模型 ID（请在「模型广场」核对准确名称）
    传入的参数值超出范围（如 temperature 填了大于 2 的值）
    对不支持某功能的模型传了不支持的参数（如对普通模型传了 thinking 参数）
    部分中转站也会把上下文超限归为 422，可同时参考 400 的处理方法

    🔌 连接 & 网络类#

    Q：提示 500 Internal Server Error？
    服务器内部出错，非你的问题。通常是上游模型服务临时故障。解决方法：
    等待 1~2 分钟后重试
    切换到同类型的其他模型
    如持续出现，可联系站长反馈
    Q：提示 502 Bad Gateway 或 504 Gateway Timeout？
    中转站与上游模型之间的连接出现问题，常见于：
    上游服务器临时过载或维护
    网络波动导致请求超时（504 多见于生成内容较长时）
    解决方法：稍等片刻后重试；如果是 504，可以尝试缩短单次请求的内容长度。
    Q：没有报错代码，但一直转圈没有响应？
    可能是请求超时但没有返回错误码。常见原因：
    网络不稳定
    模型正在排队（免费模型高峰期）
    请求的内容太长，生成时间超出客户端等待时长
    建议等待 30 秒以上，或刷新后重试。

    🛠️ 配置 & 使用类#

    Q：模型列表里没有我想要的模型？
    可联系站长申请添加，或在「模型广场」确认当前上架的模型列表。
    Q：API Base URL 该填 /v1 结尾还是不填？
    视工具而定：
    大多数工具填 https://api.yujingai.top/v1
    部分工具（如 Claude Code）填 https://api.yujingai.top（不带 /v1）
    如不确定，优先尝试带 /v1 的版本
    Q：免费模型为什么有时候很慢或失败？
    免费模型有并发限制，使用人数多时会排队，建议错峰使用或切换到付费模型。
    Q：缓存命中是什么意思？怎么触发？
    每次对话都会把上下文合并发送给模型，其中有大量重复内容。选定一个模型后不要频繁切换，系统会自动识别重复部分并以更低的缓存价格计算，最高可节省 80% 输入费用。（ps：有钱豪横当我没说）

    📋 错误码速查表#

    错误码含义最常见原因解决方向
    400请求内容有误上下文超限 / 参数格式错误清空上下文 / 检查参数
    401未授权API Key 错误或过期检查并重新创建 Key
    402余额不足账户或令牌额度耗尽充值 / 提高令牌额度
    403无权限令牌分组不包含该模型换正确分组的令牌
    413请求体过大上传文件 / 图片过大压缩文件后重试
    422内容无法处理模型名称错误 / 参数超范围核对模型名 / 检查参数值
    429请求过于频繁触发限速等待后重试 / 降低频率
    500服务器内部错误上游模型服务故障等待后重试
    502网关错误上游连接失败等待后重试
    504网关超时生成时间过长 / 网络超时缩短请求内容后重试

    八、联系我们#

    如有问题或建议，欢迎通过以下方式联系站长：
    💬 QQ：2213166743
    📱 微信：Yj_99896
    📧 邮箱：2213166743@qq.com
    © 余烬API · 本站为个人运营的 API 中转服务，如有变动以站内公告为准。
    文档最后更新：2026-06-02
    修改于 2026-06-06 23:15:25
    下一页
    余烬API · 令牌分组说明文档
    Built with