白雲超級智能 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社區

通過郵箱聯繫。

諮詢服務、交流需求或討論合作,請發送郵件。