白云超级智能 BAIYUN.SI
API 接入教程

白云 API 教程:三分钟读懂 Doken(词刀)

免费阅读

人民币付款、DK余额、Token用量:用小额例子分清参考价格、订阅成本和本站售价。 附完整检查步骤、实操验证和错误处理。

三分钟读懂词刀:Doken(DK)到底怎么算钱?

更新日期:2026年10月4日(日本时间)

1 词刀(1 DK)=按选定的商业 API 参考报价,价值 1 美元的那批 Token 用量。

词刀的英文全称是 Doken,单位写作 DK。先用商业 API 报价量出同一批 Token 有多少 DK,再核算这批 Token 分摊的 Codex 订阅美元成本,最后把实际成本美元换成人民币或日元。

这三步始终看的是完全同一批 Token,只是分别回答“用量多大”“平台花了多少钱”“成本折合多少本地货币”。本站目前 0.30 元/DK 是充值售价,不能未经实测就说它等于精确成本。

第一步:先用商业 API 报价量出 DK

Token 是 AI 阅读和生成内容的小片段,不一定等于一个汉字或一个英文单词。输入、输出、缓存等类别要按各自的参考单价计算,多轮聊天中重新读取的历史也会计入输入用量。

下面全部是教学假设,不是某个真实模型报价、订阅套餐、实测成本或实时汇率。

我们固定一批文本用量:100000 个输入 Token,加上 80000 个输出 Token。假设选定商业 API 参考表的输入价为 2 美元/百万 Token,输出价为 10 美元/百万 Token:

text
输入参考价值:100000 ÷ 1000000 × 2 = 0.2 参考美元
输出参考价值: 80000 ÷ 1000000 × 10 = 0.8 参考美元
这批用量合计:0.2 + 0.8 = 1 参考美元 = 1 DK

这里的 1 美元是商业 API 报价这把尺子上的读数,不是平台为这批 Token 实际付出的订阅费,也不是你的人民币付款金额。

换模型、换输入输出比例、命中缓存或进入不同上下文价格档位,同样 1 DK 对应的 Token 数就可能不同。因此,1 DK 不是固定数量的 Token,也不能兑换 1 美元现金。

第二步:同一批 Token,分摊多少订阅美元成本

现在保留上面完全相同的输入和输出用量,不改 Token 数、不换一批内容。我们改问:通过 Codex 订阅取得这批用量,平台实际分摊多少美元?

继续用一个简单假设:某个完整订阅周期付了 20 美元,实际完成了 500 批同型、同量的上述文本处理,没有其他用量。每批都按第一步量得 1 DK:

text
周期内完成的参考用量:500 批 × 1 DK = 500 DK
每批分摊的订阅费:20 实际美元 ÷ 500 批 = 0.04 实际美元

同一批 Token:API 参考价值是 1 美元,也就是 1 DK
同一批 Token:订阅费分摊成本是假设的 0.04 美元

像同样打印一张纸,“按张付费”和“从有限量的月套餐里分摊成本”可能算出不同金额。纸没有变,这里的 Token 用量也没有变;改变的是收费方式和使用条件。

这是按实际完成的用量平均分摊订阅费,不包含服务器、支付手续费等成本。如果实际完成的批数更少,平均成本会更高。真实核算需要订阅账单、完整周期的实际可用与已用记录,并采用适合模型和工作量的分摊方法;不能直接套用上面的假设。

不能因为订阅付了 50 美元,就保证它一定能换出固定几百 DK。 Codex 订阅有自己的可用范围和限制,不是官方商业 API 余额;API 参考金额更高,也不表示订阅费变成了更多现金。

第三步:把实际成本美元换成人民币或日元

真正要换汇的是第二步的 0.04 实际美元成本,不是第一步用于定刻度的 1 参考美元。

假设核算时 1 美元=7 元人民币、160 日元:

text
同一批 Token 的人民币订阅成本:0.04 × 7 = 0.28 元
同一批 Token 的日元订阅成本:  0.04 × 160 = 6.4 日元

这只是教学例子的成本换算,不是实时汇率或当前实测成本,也不代表开放日元收款。真实核算应明确汇率来源、时间和实际支付口径。

成本算出来了,本站售价又是什么

看的是同一批 Token 这个例子里的数字 数字的用途
商业 API 参考价值 1 参考美元=1 DK 给用量统一计量
Codex 订阅分摊成本 假设 0.04 实际美元,折合 0.28 元或 6.4 日元 平台核算成本
本站当前售价 0.30 元/DK 用户充值与消费记账

参考价值、实际成本、本站售价是三个不同的数字。 当前 0.30 元/DK 是本站定价,不是由本文假设证明的精确成本,也不表示官方商业 API 的 1 美元只卖 0.30 元现金。

本站用户分组倍率统一为 1,没有充值档位折扣。模型与输入、输出、缓存、长上下文档位仍分别按公示的参考价计量,不能重复统计;具体见模型广场。

对你来说,充值和扣费怎样看

  1. 你按当前售价支付 3 元,获得 10 DK 余额。
  2. 假设一次聊天量得 0.2 DK,就扣 0.2 DK。
  3. 余额剩下 9.8 DK;用掉的已购余额相当于 0.2 × 0.30=0.06 元,也就是 6 分钱。

这个例子不代表每次聊天固定扣 0.2 DK。扣 DK 后不会再收一次人民币,也不需要把 API 参考美元再乘外汇汇率收费。

如果以后充值价变化,应按购入时价格理解这笔余额的购入成本;你的购入成本与平台订阅成本是两回事。实际扣费和系统精度以消费记录为准。

DK 与其他单位怎样换

写法 意思 按当前 0.30 元/DK 计算
1 DK 1 词刀 购买价格 0.30 元
1 mDK 千分之一词刀,即 0.001 DK 对应已购余额 0.0003 元
1 kDK 一千词刀,即 1000 DK 购买价格 300 元
1 MDK 一百万词刀,即 1000000 DK 购买价格 300000 元
元/DK 每购买 1 DK 支付多少人民币 当前为 0.30 元/DK
DK/百万 Token 某类一百万 Token 消耗多少 DK 由模型和计价类别决定
元/百万 Token 上一行的 DK 数乘以人民币购入单价 按当前单价乘以 0.30

小写 m 是千分之一,大写 M 是一百万;1 kDK 不是 1000 个 Token。这些写法只方便表示用量,不表示当前最低充值、最大订单或小数精度;日常钱包显示 DK。

使用条件与历史说明

商业 API 与 Codex 订阅的可用范围、额度周期和使用条件不同。模型名字相同,也不能保证实际版本、上下文、工具、稳定性和使用权利完全一样。“商业 Token”不是官方划分的技术种类,不能理解为两种 Token 天生更聪明或更笨。

本站不以 OpenAI 官方 API 商业转售服务的身份销售;用商业 API 报价计量,不代表订阅包含官方 API,也不代表取得等同官方 API 的授权或服务保障。当前仅开放符合使用规则的纯文本请求。

参考报价以本站选定并公示的版本为准,不会因官网改价自动同步所有模型。上游资料可查看官方 API 报价与官方订阅用量说明。

目前使用支付宝、微信人民币充值,只按余额消耗,不推出本站会员订阅。平台订阅周期不会因此新增用户余额按周或按月清零规则。

既有四币固定报价保留在报价公示,它们不是实时汇率表,也不表示已开放对应币种收款。早期 200 美元、10 倍与四周估算的完整原文留在历史公告存档;当前理解计费请先读本页与充值说明。

实操前的检查清单

  1. 准备自己的账户与调用密钥,不使用他人的共享凭据。
  2. 记录客户端版本、系统和准备使用的模型,便于排查时复现。
  3. 保存原配置或截图,隐藏密钥、验证码与私人内容。
  4. 确认测试可能消费少量 DK,先用一句话、一次请求开始。
  5. 查阅当前模型广场与状态页,再决定是否启用更多功能。

详细排查:按顺序缩小问题范围

先确认账户已完善、密钥有效、DK 余额足够,再核对协议、地址与模型。用同一密钥做一次最小文本请求;它成功以后,才逐项恢复附件、工具或自动重试。客户端配置保存后重新打开会话,避免旧会话仍使用先前供应商。

怎样确认本节已经学会

不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议,能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准;账户教程以安全信息完善为标准;计费教程以本金、通道费与 DK 的对应关系核对为标准。

如果出现错误,记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥,也不要把密码和验证码交给其他人。对 401 应先解决认证,对 400 应先解决参数,对 429 应停止密集重试,对 404 应核对请求路径与上游是否实现,不能用重新充值解决所有报错。

一个适合练习的小任务

在自己的测试环境完成本节的最小步骤,用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能,先查看对应协议教程,再考虑添加功能;一次只变更一个配置,容易判断哪一步导致错误。

下一步与版本边界

返回完整学习地图 · API 站精简配置 · 本站实时状态。

教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化;配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准;压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。

学过了,试试看。

用 SIN1 的 100 道题检查基础知识。

参加测试

联系白云SI社区

通过邮箱联系。

咨询服务、交流需求或讨论合作,请发送邮件。