Yady API（yczc.top）客户使用手册

版本：v1.0 更新日期：2026-08-28 适用对象：第一次使用 yczc.top 的终端客户 / 开发者 文档性质：活文档。每次发现操作路径变化、页面缺失或客户反馈看不懂，都会在此追加更新，不会另起炉灶。

---

0. 写在最前：这网站到底是干嘛的？

一句话：Yady API 是一个 AI 大模型 API 中转站。你把原本发给 OpenAI / 火山引擎等上游的接口请求，改成发给 https://yczc.top/v1，就能在不用自己翻墙、不用自己申请企业授权、不用自己维护渠道的情况下，调用 DeepSeek 等模型。

适合谁：

• 个人开发者：想快速接入大模型 API，不想折腾海外支付和渠道。
• 小微企业：需要给内部工具/客服/Agent 接大模型，希望账单可控。
• 已有 OpenAI 代码的用户：几乎只改 base_url 和 api_key 就能迁移。

当前已开通的上游渠道：火山引擎官方（DeepSeek-V4-Flash）。 当前定价倍率：1.27×（后台透明设置，无隐藏加价）。 新用户福利：注册即送体验额度（以页面显示为准，当前测试账号为 20000 tokens 体验额度）。

---

1. 访问首页：第一眼要看什么

地址：https://yczc.top/

首页关键元素（从上到下）

区域	文案 / 按钮	作用
顶部导航	主页 / 控制台 / 模型广场 / 排行榜 / 文档 / 关于	公开页面入口
右上角	登录 / 通知 / 主题切换	登录后进入控制台
主横幅	“统一 API 网关，服务于海量 AI 模型”	品牌标语
主按钮	开始使用 / 查看定价 / 文档	“开始使用”=去登录/注册
右侧代码卡	curl https://yczc.top/v1/chat/completions	直接告诉你接口地址
底部	技术博客浮球	跳转博客

客户最常问：为什么首页写着“海量模型”，但模型广场显示 0 个？ 答：模型广场的数据来自后台“模型价格/元数据”配置，目前只接通了 API 渠道、尚未维护模型广场元数据（见本文末尾“已知缺口”）。实际可调用模型是 deepseek-v4-flash，不影响接口使用。

---

2. 注册账号（新客户第一步）

2.1 进入注册页

推荐路径：

1. 打开 https://yczc.top/sign-in（登录页）
2. 点击 “没有账号？ 注册”

注：直接访问 /register 会跳到默认落地页，不建议给客户发这个链接。统一发 /sign-in 再点“注册”最稳。

2.2 填写注册表单

注册表单字段：

• 用户名或电子邮件：输入用户名（建议英文+数字，如 zhangsan2026）。
• 密码：至少 8 位，包含大小写字母与数字。
• 确认密码：再输一遍。
• 同意协议：勾选“我已阅读并同意 用户协议 and 隐私政策”。
• 点击 注册 按钮。

注册成功后会自动跳转登录页或直接进入控制台。

2.3 注册后第一件事

登录后你会看到控制台“概览”页，右侧会出现一个 “首个 API 请求” 卡片，里面已经帮你写好 curl 示例，这是后面调用的关键。

---

3. 登录

地址：https://yczc.top/sign-in

步骤：

1. 输入用户名。
2. 输入密码。
3. 勾选同意协议。
4. 点击 登录。

登录后地址栏显示 https://yczc.top/dashboard，左侧出现完整菜单。

---

4. 控制台菜单总览

登录后左侧菜单（从上到下）：

菜单	路径/入口	用途
游乐场	左侧“游乐场”	网页版直接对话测试（Web UI）
聊天	左侧“聊天”	多会话聊天界面
概览	左侧“概览”	看余额、快速创建密钥、复制首个请求示例
数据看板	左侧“数据看板”	用量图表、调用趋势
API 密钥	左侧“API 密钥”	创建 / 管理 / 删除调用密钥
使用日志	左侧“使用日志”	每次 API 调用的明细
任务日志	左侧“任务日志”	异步任务日志
钱包	左侧“钱包”	充值、查看账单
个人资料	左侧“个人资料”	修改密码、查看邀请链接

顶部导航（登录后也可用）：主页 / 控制台 / 模型广场 / 排行榜 / 文档 / 关于。

---

5. 创建 API 密钥（最重要的一步）

5.1 进入 API 密钥页

点击左侧菜单 API 密钥，进入页面：

5.2 创建密钥

1. 点击右上角 + 创建 API 密钥。
2. 在弹窗里填写 名称（如“我的第一个 Yady Key”）。
3. 可选设置：

• 额度：限制该密钥最多消耗多少 tokens（填 0 或不填表示无限制）。
• 过期时间：默认不过期。
• 模型限制：默认不限制，可选只允许调用特定模型。

1. 点击 保存更改。

5.3 立即复制密钥

关键提示：保存后系统会一次性显示完整密钥，格式类似 sk-... 或一串字母数字。请务必立刻点击“复制”并妥善保存。刷新或关闭弹窗后，后台将不再显示完整密钥，只能看到 1UMT**********dt5E 这种脱敏形式。

上图右侧“首个 API 请求”卡片中的 sk-9nwX...4jon 就是系统示例，实际请替换为你自己复制的密钥。

---

6. 充值与额度

6.1 查看当前额度

在 概览 页或 钱包 页面可以看到“剩余额度”。

6.2 充值路径

左侧菜单 → 钱包 → 选择充值金额 → 完成支付。

当前状态（2026-08-28）：钱包/充值页面尚未在教程中补截图。原因是该功能依赖支付网关（Stripe/Creem/支付宝等）配置，目前后台未启用。如果你是运营人员，请优先配置支付网关后再补截图；如果你是客户，当前可用“注册赠送的体验额度”先测试接口。

6.3 额度与计费说明

• 计费按 token 计算，输入（Prompt）和输出（Completion）分别计价。
• 当前倍率 1.27×，即上游官方价格的 1.27 倍。
• DeepSeek-V4-Flash 周末/节假日按火山引擎空闲半价计费（见公告）。

---

7. 发起第一次 API 调用

7.1 接口三要素

项目	值
Base URL	https://yczc.top/v1
模型名	deepseek-v4-flash
端点	POST /v1/chat/completions
认证头	Authorization: Bearer <你的 API 密钥>

7.2 curl 示例

curl https://yczc.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的密钥" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍 Yady API"}
    ],
    "max_tokens": 100
  }'

7.3 Python 示例

from openai import OpenAI

client = OpenAI(
    base_url="https://yczc.top/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好，请用一句话介绍 Yady API"}],
    max_tokens=100,
)
print(resp.choices[0].message.content)

7.4 Node.js 示例

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://yczc.top/v1',
  apiKey: 'sk-你的密钥',
});

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [{ role: 'user', content: '你好，请用一句话介绍 Yady API' }],
  max_tokens: 100,
});
console.log(resp.choices[0].message.content);

7.5 预期成功响应（格式）

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1787890000,
  "model": "deepseek-v4-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Yady API 是..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 25,
    "total_tokens": 40
  }
}

7.6 常见报错速查

报错	原因	解决
Invalid token	API 密钥错误/被删除	去 API 密钥页重新创建并复制
insufficient quota	账户额度不足	充值或减少调用量
model not found	模型名写错	确认写 deepseek-v4-flash
channel not found	该模型后台未配置渠道	联系运营或换模型

---

8. 查看用量与日志

8.1 使用日志

左侧菜单 → 使用日志：

• 每次请求的时间、模型、消耗 tokens、状态码。
• 可按时间/模型/密钥筛选。

8.2 数据看板

左侧菜单 → 数据看板：

• 调用量趋势图。
• 按模型/密钥/状态聚合。

待补截图：使用日志页、数据看板页、游乐场页目前未在教程中配图，后续会补充。

---

9. 其他公开页面

9.1 模型广场

地址：https://yczc.top/models

现状：由于后台模型元数据未维护，模型广场目前显示“0 个模型”。这不影响接口调用，只是前端展示缺口。

9.2 排行榜

顶部导航 → 排行榜：查看各模型/用户的调用排行（需后台开启）。

9.3 文档

顶部导航 → 文档：跳转到 API 文档页。当前文档页未配置完整内容，建议客户直接参考本教程第 7 节的 curl/Python/Node 示例。

9.4 关于

顶部导航 → 关于：品牌介绍、联系方式、备案信息。

9.5 技术博客

地址：https://yczc.top/blog/

已发布 24 篇文章，包括：

• 《5 分钟上手 Yady API》
• 《OpenAI 用户迁移到 Yady 只需改 3 行》
• 《Python 调通 Yady + DeepSeek-V4-Flash 完整实战》
• 合规与风险警示系列

---

10. 邀请返利

Yady 提供邀请奖励：

• 被邀请人注册并消费后，邀请人可获得其消费金额的 8% 返利。
• 被邀请人也可获得注册赠额。

获取邀请链接：

1. 登录后进入控制台。
2. 左侧菜单 → 个人资料 或顶部用户头像下拉 → 邀请奖励。
3. 复制专属邀请链接，发送给朋友。

---

11. 客户最速路径（一页纸版）

1. 打开 https://yczc.top/sign-in
2. 点“注册” → 填用户名/密码/确认密码 → 勾选协议 → 注册
3. 登录
4. 左侧 API 密钥 → 创建 API 密钥 → 填名称 → 保存 → 立刻复制密钥
5. 在代码里把 base_url 改成 https://yczc.top/v1，api_key 改成刚复制的密钥，model 改成 deepseek-v4-flash
6. 跑一条 curl 或 Python 请求，看到回复即成功
7. 额度不够时去左侧 钱包 充值

---

12. 常见问题 FAQ

Q1：为什么模型广场显示 0 个模型？ A：后台模型元数据/价格未配置，导致前端模型广场为空。实际 API 可调用 deepseek-v4-flash。

Q2：我可以调用哪些模型？ A：当前仅 deepseek-v4-flash。后续会在后台上架更多火山引擎模型。

Q3：我是 OpenAI 用户，迁移成本高吗？ A：很低。只改 base_url、api_key、model 三个字段，代码逻辑基本不用动。

Q4：密钥泄露了怎么办？ A：进入 API 密钥页，找到该密钥，点击删除或禁用，然后重新创建。

Q5：怎么知道一次调用花了多少额度？ A：成功响应里的 usage.total_tokens 就是本次总 token 数；乘以模型单价即为费用。也可在使用日志查看。

---

13. 附录：当前已知缺口与下次更新计划

序号	缺口	影响	优先级	负责人/状态
1	模型广场显示 0 个模型	客户以为没模型可用	🔴 高	需后台配置模型价格元数据
2	首页“查看定价”按钮无有效定价页	客户看不到价目表	🔴 高	需配置模型价格并验证 /pricing 路由
3	钱包/充值页未截图	教程第 6 节缺图	🟡 中	待支付网关配置后补截图
4	使用日志页未截图	教程第 8 节缺图	🟡 中	下次截图补
5	数据看板页未截图	教程第 8 节缺图	🟡 中	下次截图补
6	游乐场页未截图	教程第 4/9 节缺图	🟢 低	有调用示例可替代
7	注册页直接访问 /register 落地页异常	不要直接发该链接	🟡 中	已在本教程中提示客户走 /sign-in → 注册

---

14. 更新记录

• 2026-08-28 v1.0：首次成稿。实地打开 yczc.top 各页面截图，用真实测试账号验证登录、创建密钥、调用接口流程，梳理出“模型广场 0 模型”“定价页缺失”等 7 项待补缺口。