简体中文繁體中文English
登入 免費開始
Usage · 用量查詢

怎麼查 9Coding 的用量與餘額

「還剩多少」「剛才那次花了多少」「這個月一共用了多少」——三個問題，三個地方。網頁端一眼能看的先看網頁端，要接進自己監控的用 API。下面每一項都註明在哪查、能查到什麼。

速查：你想知道什麼

你想知道去哪查能看到
還剩多少錢控制台總覽賬戶餘額（永不過期）
錢是怎麼進來的錢包頁充值與入賬記錄
剛才那次花了多少日誌頁逐次呼叫 + tokens 明細 + 單價
為什麼這次特別貴日誌頁展開輸入/輸出/快取 tokens 分別多少
接進自己的監控billing API程式化讀取
哪個 Key 在用Key 管理頁Key 列表與狀態

網頁端

賬戶餘額 —— 控制台總覽#

在哪
登入後進控制台，首頁就是總覽。
看什麼
「賬戶餘額」卡片顯示當前可用餘額，標註為永不過期。充值的和贈送的進同一個餘額，呼叫時按實際用量扣減。
注意
餘額是實時扣減的，但一次呼叫從發出到入賬有極短延遲。剛跑完一個大任務就去看餘額，可能還差最後一兩筆沒結算——隔幾秒重新整理即可。

充值與入賬記錄 —— 錢包頁#

在哪
控制台左側「錢包」。
看什麼
當前餘額、充值入口、每筆充值的到賬明細（本金與贈送分別列出）、兌換碼兌換記錄。
用途
對賬用。「我充了多少、實際到賬多少」在這裡一目瞭然；餘額對不上時，先在這裡確認入賬，再去日誌頁看支出。

每次呼叫花了多少 —— 日誌頁#

在哪
控制台左側「日誌」。
看什麼

按呼叫逐條記錄。展開任意一條能看到這次呼叫的明細：

  • 輸入 tokens、輸出 tokens、快取 tokens 各是多少
  • 該模型的輸入 / 輸出 / 快取單價（按每 100 萬 tokens 計）
  • 這次呼叫扣掉的額度
為什麼重要

「為什麼這次特別貴」幾乎總能在這裡找到答案。最常見的兩種情況：輸入 tokens 遠大於預期（把整個大檔案或長曆史一起發出去了），或者輸出很長（讓它寫了大段程式碼）。

快取 tokens 單獨計價，長會話裡它的佔比往往比想象中大——如果你的成本主要來自快取段，說明會話歷史該清理了。

哪把 Key 在用 —— Key 管理頁#

在哪
控制台左側「API Key」。
看什麼
已建立的 Key 列表與狀態。一把 Key 即可呼叫全部模型，不分檔。
建議
不同用途（本地開發 / CI / 線上服務）分開建 Key。出問題時可以單獨停掉一把而不影響其它，日誌也更容易歸因。

用 API 查

要接進自己的監控面板或定時對賬指令碼，用 billing 端點。9Coding 提供 OpenAI 風格的兩個介面：

terminal
# 用量
curl -s https://api.9coding.com/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $YOUR_KEY"

# 訂閱 / 額度
curl -s https://api.9coding.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $YOUR_KEY"
響應欄位以你的實際返回為準。不同閘道器對這兩個端點的欄位命名不完全一致，寫解析程式碼之前先跑一次把結構打出來，比照著任何文件猜都可靠。這也是對接任何第三方 API 的通用做法。

順帶一個實用技巧：怎麼確認某個端點存不存在

找介面時經常要試路徑。不必拿真實 Key 去撞——用一把無效 Key 就能分辨，因為兩種失敗的響應完全不同：

返回含義
401 + Invalid token路由存在，只是鑑權沒過 → 換成有效 Key 就能用
404 + Invalid URL (GET /xxx)閘道器上沒有這個路由 → 路徑寫錯了，別再試

換句話說：401 是好訊息，說明你找對了地方。這個方法不暴露真實 Key，也不會產生任何費用。

用量對不上怎麼辦

  1. 先確認這筆呼叫有沒有入賬——去日誌頁找那個時間點。日誌裡沒有這條記錄，說明請求根本沒到服務端，那是接入問題不是計費問題，走 連線錯誤排查。
  2. 日誌有記錄但金額不對——展開看 tokens 明細。多數情況是輸入 tokens 比預想的大得多。
  3. 餘額少得比日誌快——檢查是不是有多個客戶端共用同一把 Key（本地、CI、線上服務同時在跑）。分 Key 之後就能在日誌裡區分開。
  4. 還是對不上——把日誌裡那條記錄的時間、模型名和完整錯誤文字（如有）提交給我們，錯誤響應裡的 request id 能直接定位到那一次呼叫。

相關

免費開始 連線排查