白云 API 教程：充值与余额消费
Doken（DK）数量、0.30元/DK人民币付款、支付宝微信与按用量消费。 附完整检查步骤、实操验证和错误处理。
充值与余额消费
本站暂不推出会员订阅计划，只采用余额消耗模式：充多少用多少，按实际模型调用扣费。不设置用户分组的额外倍率，也没有充值档位折扣。
人民币付款，Doken 记余额
1 词刀（1 DK）＝按选定商业 API 参考报价，价值 1 美元的那批 Token 用量。 英文全称是 Doken，单位写作 DK。这是用量定义，不是平台实际支付了 1 美元订阅费，也不等于可兑换 1 美元现金。
本站按这个单位记余额和消费。当前充值售价为 0.30 元/DK，10 DK 的充值金额为 3 元，100 DK 的充值金额为 30 元，另付下述支付通道费；售价不等于未经实测的精确订阅成本。DK 不代表固定字数或 Token 数量。想了解同一批 Token 怎样从参考价值算到订阅成本，再换人民币或日元，可看三分钟读懂 Doken。
易支付上游收取充值金额的 5% 作为支付通道费。预计实付＝充值金额＋支付通道费。 通道费由易支付上游收取，不计入 DK 余额；充值售价和到账 DK 数量不变。
| 充值数量 | 充值金额（人民币） | 支付通道费（5%） | 预计实付（人民币） |
|---|---|---|---|
| 1 DK | ¥0.30 | ¥0.02 | ¥0.32 |
| 10 DK | ¥3.00 | ¥0.15 | ¥3.15 |
| 100 DK | ¥30.00 | ¥1.50 | ¥31.50 |
| 200 DK | ¥60.00 | ¥3.00 | ¥63.00 |
例如充值 200 DK：充值金额 60 元，支付通道费 3 元，预计实付 63 元，到账仍为 200 DK。表中金额按人民币分展示，小额费用可能存在分币舍入，最终实付以支付收银台显示为准。
钱包中的充值数量按 DK 填写；付款确认中的充值金额、支付通道费和预计实付都是人民币。当前最低充值数量为 1 DK。请在下单前核对数量、预计实付和支付方式。
当前支付方式
当前接入支付宝、微信易支付通道，订单按人民币付款。其他支付入口暂未开放。历史公告中的日元、港币、美元固定报价属于报价公示，不能据此理解为当前已经开放这些币种的收款。
收款确认后依订单状态入账。如果已支付但余额尚未更新，请先查看充值记录与订单状态，保留订单号和时间联系管理员；不要反复支付同一订单，也不要把商户或支付密钥发给任何人。
调用怎样扣费
模型单价区分输入、输出、缓存与长上下文档位。不同模型完成同样问题，Token 数和消费可能不同；价格以模型广场及实际消费记录为准。
例如某次调用按公示价格计得 0.2 DK，则余额扣除约 0.2 DK；按当前充值价，相当于使用了 0.2 × 0.30＝0.06 元，也就是 6 分钱的已购余额。它不是额外再收一次人民币。
每次请求的 Token 数和计价类别都会影响消费，不能承诺一句话固定花 0.2 DK，也不能用 1 DK 固定兑换某个字数。
缓存优惠与长上下文档位是模型本身的计价类别，不是特殊用户倍率。本站分组倍率统一为 1。
报错、拦截与取消
本地安全拦截的请求不进入上游，也不产生本次模型调用扣费。进入上游后的正常请求及失败请求，由系统预扣、结算和退款逻辑处理；客户端取消、断线或报错并不统一等于零费用。发生疑问时以消费记录、请求编号与订单记录核对。
平台订阅和你的余额怎样区分
平台核算成本时，应先按商业 API 参考价量出同一批 Token 的 DK，再根据 Codex 订阅账单与实际用量分摊美元成本，最后按明确汇率换成人民币或日元。它不能由当前 0.30 元/DK 的售价反推，也不能保证某笔订阅费固定提供多少 DK。
你在本站购买的是 DK 余额，没有购买本站会员订阅，也没有因为平台的订阅周期而新增按周或按月清零规则。
当前通俗说明见三分钟读懂 Doken。完整的早期成本测算留在历史公告存档，其中旧估算不是当前额度保证。
当前用户服务方式以本页与使用规则为准。价格或开放范围变化时，会在公告与文章中公示。
实操前的检查清单
- 准备自己的账户与调用密钥，不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型，便于排查时复现。
- 保存原配置或截图，隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK，先用一句话、一次请求开始。
- 查阅当前模型广场与状态页，再决定是否启用更多功能。
详细排查：订单创建不等于付款成功
先核对数量、本金、通道费和实付，再到真实收银台完成付款。页面提示处理中时，核对支付账户实际扣款和本站订单状态；不要不断新建同一笔订单。未到账时提交订单号、时间与脱敏付款记录，不提交支付密码。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议，能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准；账户教程以安全信息完善为标准；计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误，记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥，也不要把密码和验证码交给其他人。对 401 应先解决认证，对 400 应先解决参数，对 429 应停止密集重试，对 404 应核对请求路径与上游是否实现，不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤，用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能，先查看对应协议教程，再考虑添加功能；一次只变更一个配置，容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化；配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准；压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。