Token Plan 個人版的額度、購買、訂閱和接入常見問題。
額度與限額
5 小時/7 天限額是什麼意思？
Token Plan 個人版採用每 5 小時滾動視窗和每 7 天固定視窗雙重限額，限額單位為 Credits。任一視窗累計消耗達到限額後暫停服務，需等待對應視窗結束後額度重設。視窗期內未用完的額度不結轉至下一周期。其中每 5 小時限額當前限時取消，暫不限制。
例如：Standard 套餐的 7 天限額為 10,000 Credits。您在 7 月 20 日首次調用，系統開啟視窗（7 月 20 日 ~ 7 月 27 日）。7 月 20 日消耗 4,000 Credits，7 月 22 日消耗 6,000 Credits，累計 10,000 Credits 觸頂暫停。需等到 7 月 27 日視窗結束，額度重設為 10,000 Credits，服務恢複。
各檔位限額如下：
檔位 | 5 小時限額 | 7 天限額 |
|---|---|---|
Lite 套餐 | 700 Credits | 2,500 Credits |
Standard 套餐 | 3,000 Credits | 10,000 Credits |
Pro 套餐 | 12,000 Credits | 40,000 Credits |
7 天限額是固定日期重設嗎？
不是。7 天限額採用固定視窗機制，自首次調用起計時 7 天，到期後額度重設。重設時間取決於您首次調用的時間，而非固定的日曆日期（如每周一）。
額度用完了怎麼辦？
限額用完後調用會被阻斷，不會隨用隨付。恢複方式：
- 等待額度釋放。
- 升級套餐。
- 購買用量包，獲得不受限額約束的額外額度。
什麼是重設卡？如何使用？
重設卡是 Token Plan 個人版訂閱使用者的一次性額度重設權益。在 Token Plan 訂閱頁面的套餐額度地區，可以看到重設限額按鈕，按鈕旁標註剩餘可用次數（如“1 次可用”），單擊旁邊的 info 表徵圖可查看提示“使用重設卡可立即重設套餐額度”。單擊重設限額按鈕即可立即重設套餐額度。該權益為一次性發放，非定期發放，發放時不單獨發送郵件通知。
開通 Token Plan 後為什麼仍產生按量計費？
開通 Token Plan 後仍看到按量計費，通常是以下原因導致：
- 生效前調用：開通 Token Plan 之前發生的調用屬於獨立計費，無法被套餐抵扣。
- 配置錯誤：未使用 Token Plan 專屬 API Key 和 Base URL（例如誤用百鍊通用 dashscope.aliyuncs.com 或 Coding Plan 的 Key），導致請求走隨用隨付通道。
- 模型不支援：調用了 Token Plan 白名單之外的模型（如 Qwen3-VL-Plus 及部分子型號）。
用量包和套餐是什麼關係？需要先買套餐嗎？
用量包是套餐的補充，提供不受套餐限額約束的額外 Credits，需先訂閱有效套餐後才能購買，最多同時持有 5 個。
用量包的額度有視窗限制嗎？
沒有。用量包額度不受套餐的 5 小時和 7 天視窗限額約束，購買後即可使用。
用量包有效期間多久？
用量包有效期間為 1 個月，到期後未使用的額度自動作廢，不支援退款。
Token Plan 的用量在哪裡查看？
在百鍊控制台的 Token Plan > 我的訂閱 頁面查看當前訂閱的 Credits 額度及消耗情況。
為什麼賬單/外掛程式統計的 Credits 消耗與預期不一致？
Credits 消耗與賬單或外掛程式統計出現差異，常見原因：
- 上下文快取命中：命中緩衝時抵扣係數較低，未命中時抵扣係數較高。
- 模型系列差異：不同模型（如 Qwen 系列與 GLM 系列）的 Credits 抵扣係數不同。
- 功能模式影響：頻繁切換工具調用或思考模式可能影響計費。
Token Plan 是否提供免費試用額度或贈送 Token？
Token Plan 套餐本身不提供試用額度，也不包含免費贈送的 Token 額度。百鍊平台針對部分模型提供獨立的免費額度，可以在控制台查詢可用免費額度的模型列表。
如何減少 Token Plan 的 Credits 消耗？
- 壓縮歷史訊息或新開交談視窗，避免長上下文累積消耗。
- 關閉思考模式（Thinking Mode）以降低推理開銷。
- 非複雜任務情境下切換至輕量模型（如 qwen3.6-plus 替代 qwen3.7-max）。
- 利用緩衝機制，快取命中的 Token 計費價格低於正常 Input Token。
- 通過用量分析頁面監控消耗明細，及時調整使用原則。
為什麼第三方工具（如 Claude Code）顯示的 Token 用量與百鍊控制台統計不一致？
- 統計口徑不同：第三方工具僅顯示模型層面的輸入輸出 Token；百鍊控制台統計包含完整消耗項。
- 隱藏消耗項：系統提示詞、工具定義（Schema）、使用者配置、專案約定、多輪對話歷史累積、工具調用參數與返回結果、模型內部推理內容（reasoning）等，均會計入 Credits 消耗但不在第三方工具中顯示。
- 模型單價影響：Credits 消耗與模型抵扣係數相關，高價模型（如 qwen3.7-max）會導致相同 Token 數下 Credits 消耗更高。
- 最佳化建議：通過百鍊控制台 Token Plan 訂閱頁的用量分析查看官方統計；使用
/compact壓縮歷史訊息或/clear新開對話以減少上下文累積。
接入報錯
常見報錯及解決方案
報錯資訊 | 可能原因 | 解決方案 |
|---|---|---|
401 InvalidApiKey: No API-key provided. | 要求標頭中未攜帶 API Key | 產生 API Key 並在工具中完成配置 |
401 InvalidApiKey: Invalid API-key provided. | 誤用了隨用隨付的 API Key 或 Coding Plan 的 Key；訂閱到期；Key 複製不完整 | 確認使用 Token Plan 個人版 API Key，確保完整且無空格 |
404 model_not_found: Model not exist. | 模型名稱拼字錯誤或不在支援列表 | 確認模型名稱區分大小寫，與套餐支援的模型 ID 一致。 |
403 AccessDenied.Unpurchased: Access to model denied. | 調用的模型僅團隊版支援，個人版不支援 | 改用個人版支援的模型，或使用 Token Plan 團隊版 |
401 invalid access token or token expired | 誤用了 Coding Plan 或其他計費模式的 Base URL | 使用 Token Plan 個人版 Base URL |
401 Incorrect API key provided | 誤用了百鍊通用 Base URL（dashscope.aliyuncs.com） | 使用 Token Plan 個人版 Base URL |
429 Requests rate limit exceeded | 短時間內請求過於密集 | 等待一分鐘後重試，降低請求頻率 |
429 Allocated quota exceeded | 5 小時或 7 天限額用盡 | 等待視窗釋放額度 |
400 invalid_parameter_error: Unexpected item type in content. | 向純文字模型傳入了映像等非常值內容 | 改用支援該模態的模型，或確認請求內容與模型能力匹配 |
502 Bad Gateway | 服務端偶發異常 | 稍後重試 |
Token Plan 用量顯示為 0 或調用仍計費/欠費怎麼辦？
- 用量顯示為 0 通常是因為尚未產生實際消耗，或使用了非 Token Plan 專屬 API Key。
- 調用仍扣餘額或產生欠費，是因為配置了普通 API Key 而非套餐專屬 Key。
並發與效能
最多支援多少個 Agent 並發？
並發能力與套餐檔位相關：
檔位 | 建議並發 |
|---|---|
Lite 套餐 | 可同時支援 1-2 個 Agent 並發運行 |
Standard 套餐 | 可同時支援 3-4 個 Agent 並發運行 |
Pro 套餐 | 可同時支援 6-8 個 Agent 並發運行 |
高峰期響應會變慢嗎？
高峰期可能出現排隊等待。如需更穩定的吞吐，可升級到更高檔位或使用團隊版。
Token Plan 的限流閾值（TPM/RPM）是多少？能否提升？
官方未公開具體的 TPM/TPS/RPM 數值，限流閾值會根據整體負載動態調整以保障服務穩定性。套餐限流額度不支援提升。
最佳化建議：精簡上下文、降低任務複雜度以減少單次輸入 Token 數量；遇到限流時等待約 1 分鐘後重試。
使用規則
"禁止 API 生產自動化調用"具體是什麼意思？
Token Plan 個人版僅供個人通過官方指定工具（如 Cursor、Claude Code、Windsurf 等）進行互動式開發。不允許將 API Key 用於生產環境的自動化服務、批量指令碼或後台定時任務等非互動情境。
多人共用一個帳號可以嗎？
不可以。Token Plan 個人版限單人使用，不允許多人共用同一帳號或 API Key。如需多人協作，請使用 Token Plan 團隊版。
可以在多台裝置上使用同一個 API Key 嗎？
可以。Token Plan 個人版每個訂閱對應一個專屬 API Key，產生後請立即複製並妥善儲存。您可以將同一個 API Key 配置到多台裝置（如家庭電腦和公司電腦）上使用，無需為每台裝置重建。
購買與訂閱
RAM 使用者可以使用 Token Plan 嗎？
可以，需由主帳號完成以下授權：
- 在 RAM 控制台為該 RAM 使用者授予
AliyunTokenPlanReadOnlyAccess（唯讀）或AliyunTokenPlanFullAccess（管理）系統策略，同時授予AliyunBSSReadOnlyAccess系統策略。 - 在百鍊控制台帳號管理頁面，為該 RAM 使用者指派管理員或訂閱套餐許可權。
可以升配嗎？升配後額度怎麼算？
支援從低檔位升級到更高檔位。升級按剩餘時間長度補繳價差，升級後限額立即提升至新檔位對應額度。
可以降配嗎？
不支援降配。如需更換為更低檔位，可在訂閱到期後重新購買。
自動續約怎麼取消？
登入Model Studio 控制台 Token Plan 頁面，在訂閱管理中關閉自動續約。
如何查看 Token Plan 套餐的生效時間和剩餘天數？
- 生效時間查看路徑：登入百鍊控制台的 Token Plan 頁面查看套餐生效時間。
- 剩餘天數顯示邏輯：控制台顯示的剩餘天數為向下取整後的完整 24 小時周期數，實際有效期間以具體結束時間戳記為準（例如剩餘 22 天 20 小時會顯示為 22 天），屬正常顯示邏輯。