✦ YI API 极速接入与接口地址填写说明

在客户端配置连接时，请先在本站 「API 密钥（令牌）」 页面复制您的 sk-xxxxxx 密钥，并根据您所使用的客户端要求，从以下两种接口地址中任选其一填写（如遇连接报错，切换另一种即可）：

• 标准接口地址（不带 /v1）：
  https://api.218529.xyz
  （适用于会自动补全路径的客户端）
• 兼容接口地址（带 /v1，最常用）：
  https://api.218529.xyz/v1
  （适用于要求填写完整 OpenAI 兼容端点的客户端）
• 备用主站地址：
  https://yi.218529.xyz 或 https://yi.218529.xyz/v1

✦ YI API 常见报错代码自查（遇到报错请先对照此处，无需联系站长）

📌 自助排查说明： 99% 的连接与调用异常均可通过下方代码在 1 分钟内自行解决。站长仅处理 「账号异常」 与 「兑换码异常」，联系时请务必附带 【站内用户名 + 订单号】。

• 报错 401 (Unauthorized / Invalid API Key) —— 密钥或地址无效
  • 原因： 您的令牌（sk- 开头的那串钥匙）填错了、没有复制完整、前后多带了空格，或者接口地址未填写正确。
  • 自查办法： 请回到本站「API 密钥」页面重新点击复制密钥并粘贴，同时确认该令牌处于「启用」状态。
• 报错 402 / 403 (Quota exceeded / Forbidden / 余额或权限不足) —— 额度不足或令牌受限
  • 原因： 您的账户总余额已用完（本站新注册初始额度为 0），或者您给当前令牌单独设定了过低的额度限制 / 模型限制。
  • 自查办法：
    1. 请前往控制台「钱包」页面查看账户剩余额度，如为 0 请先使用兑换码补充额度。
    2. 进入「API 密钥」页面编辑您的令牌，确认已开启 「无限额度」，且未勾选错误的模型或分组限制。
• 报错 404 (Not Found) —— 路径后缀或模型名称不匹配
  • 原因： 接口地址末尾 漏填了 /v1 或 多填了 /v1；又或者您手动输入的模型名称拼写有误。
  • 自查办法：
    1. 若当前地址未加 /v1，请在末尾加上 /v1 重试；若已加 /v1 仍报 404，请删掉 /v1 重试。
    2. 请勿手打模型名称，直接前往本站「模型广场」点击复制标准模型名称（注意大小写与横杠）。
• 报错 429 (Too Many Requests / 速率限制) —— 请求过于频繁或通道拥挤
  • 原因： 短时间内连续点击发送请求太快，或者海外官方上游当前时刻并发拥挤触发了限流保护。
  • 自查办法： 请停止连续点击，等待 10 ~ 15 秒后再重新发送即可。
• 报错 500 / 502 / 503 (Server Error / Bad Gateway) —— 上游波动或参数超限
  • 原因： 海外官方服务器（如 Claude / OpenAI 官方）正在短暂抽风，或您单次发送的上下文过长、参数（如温度 Temperature 超过 1.0）超出官方限制。
  • 自查办法： 非本站故障，请稍等片刻后重试；若持续报错，请检查客户端 Temperature 是否控制在 1.0 以内，或适当调小最大回复长度（Max Tokens）。
• 报错 524 (A Timeout Occurred) —— 响应生成超时
  • 原因： 模型生成长文本或深度思考耗时较长，等待总时长超过网关超时阈值。
  • 自查办法： 请在您的客户端设置中开启 「流式传输（Streaming / 流式输出）」，让文字实时逐字输出即可彻底避免超时。