教程
    • 余烬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