白云 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:
输入参考价值: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:
周期内完成的参考用量: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 日元:
同一批 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,没有充值档位折扣。模型与输入、输出、缓存、长上下文档位仍分别按公示的参考价计量,不能重复统计;具体见模型广场。
对你来说,充值和扣费怎样看
- 你按当前售价支付 3 元,获得 10 DK 余额。
- 假设一次聊天量得 0.2 DK,就扣 0.2 DK。
- 余额剩下 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 倍与四周估算的完整原文留在历史公告存档;当前理解计费请先读本页与充值说明。
实操前的检查清单
- 准备自己的账户与调用密钥,不使用他人的共享凭据。
- 记录客户端版本、系统和准备使用的模型,便于排查时复现。
- 保存原配置或截图,隐藏密钥、验证码与私人内容。
- 确认测试可能消费少量 DK,先用一句话、一次请求开始。
- 查阅当前模型广场与状态页,再决定是否启用更多功能。
详细排查:按顺序缩小问题范围
先确认账户已完善、密钥有效、DK 余额足够,再核对协议、地址与模型。用同一密钥做一次最小文本请求;它成功以后,才逐项恢复附件、工具或自动重试。客户端配置保存后重新打开会话,避免旧会话仍使用先前供应商。
怎样确认本节已经学会
不要只检查「配置保存成功」提示。你应能说清当前 Base URL、密钥用途、选用模型和请求协议,能在相应控制台核对自己的操作结果。客户端教程以一次实际纯文本响应和对应日志为初步完成标准;账户教程以安全信息完善为标准;计费教程以本金、通道费与 DK 的对应关系核对为标准。
如果出现错误,记录发生时间、HTTP 状态、脱敏错误内容以及实际期待的结果。不要截图整页密钥,也不要把密码和验证码交给其他人。对 401 应先解决认证,对 400 应先解决参数,对 429 应停止密集重试,对 404 应核对请求路径与上游是否实现,不能用重新充值解决所有报错。
一个适合练习的小任务
在自己的测试环境完成本节的最小步骤,用文字记录「原来怎么设置、改了哪一项、看到了什么结果」。不把生产数据、真实付款或不可恢复的命令当练习。遇到超出本节的功能,先查看对应协议教程,再考虑添加功能;一次只变更一个配置,容易判断哪一步导致错误。
下一步与版本边界
返回完整学习地图 · API 站精简配置 · 本站实时状态。
教程于2026年10月9日整理。具体界面与能力可能随客户端和上游版本变化;配置指引不等于所有客户端版本已经实测通过。本站余额消费、QQ / 支付宝登录及已开放通路以实际页面为准;压缩接口此前的上游 404、生图尚无可用渠道等限制不要理解为配置文件能自动消除。