白云 API 教程:用量、日志与费用核对
用量单位、缓存、实际消费及异常核查。 附完整检查步骤、实操验证和错误处理。
用量、日志与费用核对
三个不同的数字
Token 是模型处理的用量单位;DK 是本站余额与参考计价单位;人民币是充值实际付款币种。1 DK 对应按选定商业 API 参考价量出的 1 美元那批 Token,不固定 Token 个数,不能兑换美元。
从一条记录开始
在用量日志限定调用时间,核对模型、输入、输出、缓存、耗时与实际扣款。一次客户端操作可能发出多条请求;Agent 的多轮工具调用也可能分别计费。不要只用界面显示的最后一句话长度估算全部用量。
模型与上下文价格
价格以模型广场为准。不同模型、输入、输出、缓存和上下文档位可能采用不同费率。工具没有显示缓存字段时,也应查看服务端用量记录,不把缓存当成所有输入免费。
充值核对
当前本金按 0.30 元/DK 换算,支付通道费按收银台显示;例如购买 10 DK,本金 3 元,加 5% 通道费为 3.15 元。最后以订单页面实际金额为准。通道费不进入 DK 余额,订单创建不代表已经付款到账。
遇到异常
记录时间、模型、脱敏请求信息和订单号,核对是否重复发送、自动重试或同时运行了其他客户端。不要提交完整密钥、密码或验证码。余额不足应充值或停止调用,不要尝试用上游额度重置替代本站余额。
实操前的检查清单
- 准备自己的账户与调用密钥,不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型,便于排查时复现。
- 保存原配置或截图,隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK,先用一句话、一次请求开始。
- 查阅当前模型广场与状态页,再决定是否启用更多功能。
详细排查:一轮操作可能有多条请求
客户端自动总结、标题生成、重试、Agent 工具轮次都会增加请求。先记录测试开始和结束时间,用对应区间对照日志。检查是否同时开着多个客户端,避免把其他程序的用量算成当前一次调用。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议,能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准;账户教程以安全信息完善为标准;计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误,记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥,也不要把密码和验证码交给其他人。对 401 应先解决认证,对 400 应先解决参数,对 429 应停止密集重试,对 404 应核对请求路径与上游是否实现,不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤,用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能,先查看对应协议教程,再考虑添加功能;一次只变更一个配置,容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化;配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准;压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。