申請流程
要使用 Claude Messages Count Tokens API,首先到 Ace Data Cloud 控制台 取得您的 API Token,留作備用。
如果你尚未登入或註冊,會自動跳轉到登入頁面邀請你註冊和登入,完成後會自動返回目前頁面。
一個 API Token 即可呼叫平台所有服務,無需為每個服務單獨申請。 首次申請會贈送免費額度,可免費體驗;額度不足時可在 控制台 儲值通用餘額。
📘 完整文件:Claude Messages Count Tokens API →
基本使用
Claude Messages Count Tokens API 的請求路徑為/v1/messages/count_tokens,與 Anthropic 官方 API 保持一致。我們至少需要提供兩個必填參數:
model:選擇使用的 Claude 模型,如最新旗艦claude-fable-5-1;原claude-fable-5仍相容保留。messages:輸入的訊息陣列,每條訊息包含role(角色)和content(內容)。
system:系統提示詞,會計入 Token 數量。tools:工具定義,會計入 Token 數量。thinking:擴展思考設定。tool_choice:工具選擇設定。cache_control:頂層或內容區塊級快取控制設定。
messages、system、工具呼叫回放、URL 圖片和 document/PDF 內容區塊使用與 Messages API 相同的穩定請求結構。
cURL 範例
Python 範例
使用 Anthropic SDK
Claude Messages Count Tokens API 接受 Anthropic SDK 的穩定請求結構,可以透過anthropic 函式庫呼叫。介面使用所選模型對應的原生 Count Tokens 能力統計輸入,可用於在傳送 Messages 請求前檢查輸入規模。
包含工具的 Token 計數
如果你的請求中包含工具定義,這些工具也會計入 Token 數量:包含系統提示詞的 Token 計數
系統提示詞也會計入 Token 數量:注意事項
- 該 API 僅計算輸入 Token 數量,不會產生任何模型輸出。
- Token 計數結果可用於預估輸入規模和檢查上下文視窗;最終計費以實際 Messages 回應中的
usage為準。 - 圖片、PDF、工具定義、系統提示詞和 thinking 設定會按照所選模型的輸入規則計入結果。
- 該 API 完全免費,不消耗任何額度。

