why01 API 文档

主题

新手上路（5 分钟拿到第一个 API Key） ​

这页是给谁的

  • 没用过 API 的人——不知道什么是 API、什么是 Key、为什么要这么搞
  • 不想点开七八个详情页的人——跟着走完这页就能用上

如果你已经知道怎么回事 → 直接看 5 步快速开始（含代码示例）；如果你想深入了解每个概念 → 每一步下面都有「想懂为什么」的链接。

先用两句话解释你即将做什么 ​

  • API = 一个固定网址，你的软件（Cherry Studio、Claude Code、各种聊天客户端...）通过它把你输入的内容发给 AI、再把 AI 的回答拿回来。它就是"软件和 AI 之间通信用的入口"
  • API Key = 这个入口的门禁卡 + 信用卡二合一——你的软件每次访问 API 都要带上这串字符，访问按用量从你这张卡里扣钱。别人拿到 = 用你的钱，所以要保管好

why01 的角色：把 OpenAI、Anthropic、Google 三家的 API 入口聚到一个网址下，你只用一把 Key 就能调三家任一模型——而且充人民币就能用，不用各自找官方开美元账号。

下面 5 分钟带你从零拿到自己的 Key。

第 1 步:注册账号(30 秒) ​

打开 https://s1.why01.top → 右上角「登录 / 注册」→ 切到「注册」标签。

  • 账号:自己取一个名字,没人占用就能用(比如 xiaoming001)
  • 密码:至少 8 位,自己记住
  • 提交即可。不用收验证码、不用绑手机

把密码存好

当前不支持邮箱 / 短信自助找回——密码丢了只能 联系客服 人工核实，比较麻烦。注册时建议直接把密码存进密码管理器（1Password / Bitwarden 等）。

想懂更多 → 注册账号详情

第 2 步:充点钱(2 分钟) ​

控制台 → 左侧菜单「钱包 / 充值」→ 选金额 → 支付宝扫码 → 秒到账。

进充值页先看清楚选的是哪个 Tab

充值页默认打开的 tab 是「订阅购买」(套餐) ——不是按量充值。两者区别:

  • 余额充值(切到这个 tab):按量计费,充多少存多少,用一次扣一次,余额永久有效。不知道买啥就选这个。
  • 订阅购买:打包套餐,可能含折扣 / 赠送额度,一经购买不予退款(详见 售前售后 § 退款政策)。看得懂套餐能给你省钱的人自己决定;看不懂 / 第一次用 → 无脑选余额充值就对了。

第一次充多少?

建议 ¥50 起步。 ¥10 对贵模型(比如 Claude Opus、GPT-5)用户来说一晚上就刷完,根本验证不了正常使用的成本节奏。 充 ¥50 跑两三天,看 日志 实际消耗,再决定要不要加充到一个月预算。

怎么算贵不贵?

  • 便宜档(各家的 mini / haiku / flash 类):¥50 够你聊一两周
  • 中档(主力 sonnet / 主流 GPT 系):¥50 可能两三天就用完
  • 顶级(opus 顶配 / GPT 最贵档):¥50 一晚上写代码就刷完了

具体怎么估算 → 价格说明 § 多少钱算够用 有哪些可选模型 + 实时单价 → 控制台模型页

想懂更多 → 充值详情

第 3 步:创建你的第一个 API Key(20 秒) ​

控制台 → 左侧菜单「令牌管理」→ 右上角「添加令牌」→ 填表:

字段填什么
名称随便取,比如 my-first-key
其他所有字段全部留默认——不要动

点「提交」。

复制 Key,立刻保存好

创建后只显示一次完整 Key——形如 sk-xxxxxxxxxxxxxxxx。

立即复制,贴到这些地方任一个:

  • 密码管理器(推荐 1Password / Bitwarden)
  • 本地一个安全的文本文件(用完之后删掉)
  • 至少先记在手机便签里——关闭这个页面后就再也看不到完整值了

如果不小心关了页面没复制?到「令牌管理」列表点「编辑」→ 删了旧的、新建一个。

想懂 Key 各字段是什么 / 什么时候要去设额度 / 过期时间 → 创建 Key 详情

第 4 步:把 Key 用起来 ​

你现在有了:

API 地址(Base URL): https://s1.why01.top
API Key:           sk-xxxxxxxxxxxxxxxx (你刚才复制的)

把这两个值填到任何兼容 OpenAI 协议的工具里就能用。按你想用的工具选一个:

你想用什么看哪页
桌面端聊天(像 ChatGPT 网页版那样)Cherry Studio — 推荐新手
写代码,让 AI 帮你改文件Claude Code — 命令行,需要装 Node.js
在 IDE 里写代码Cursor IDE
自己写代码调OpenAI 兼容接入 — 给会写 Python / JS 的人

完全不知道选哪个?

装 Cherry Studio——它是个桌面软件,装上、填两个值、就能聊。最接近 ChatGPT 的体验。

你刚才做了什么(可选阅读) ​

如果你还想理解一下"刚才那 4 步背后的逻辑":

  1. 注册——在 why01 开一个账户,后续充值、Key 都挂在这个账户下
  2. 充值——把钱存进账户,用一次扣一次,扣完就停(不会透支)
  3. 创建 Key——给你的程序 / 客户端发一张"门禁卡 + 信用卡",程序拿着这张卡去 why01 调 AI,why01 看到卡才会扣你的钱
  4. 用 Key——把这张卡(Key)+ 入口网址(Base URL)填到客户端里,客户端就能调 GPT、Claude、Gemini 任一个了

一个 Key vs 多个 Key

自己一个人用,一个 Key 就够了。

只有把 Key 借给别人 / 装到不能随便控制的设备(比如 VPS / IoT 设备) / 给生产业务用,才需要多建几个 Key + 设额度上限 + 设过期时间——目的是限制每个 Key 单独能花多少钱,泄露了损失可控。

新手不用考虑这些。

还没解决问题? ​

下一步 ​

按你要用的工具走一页就够了: