計費常見問題

關於 credit 與計費的常見問題。

失敗的請求會扣 credit 嗎？

不會。credit 只在成功（2xx）回應時扣除。任何 4xx／5xx 錯誤都不扣點。

我怎麼即時知道餘額？

每個成功回應的 X-Credit-Remaining header（以及 meta.credit_remaining）都會帶當前餘額。建議在你的系統中記錄此值，於低水位時提前告警。

每次呼叫扣多少點？

依端點而定，每個端點有各自的成本權重。實際扣除量會出現在回應的 X-Credit-Cost。管理與系統端點為 0。

餘額用完了會怎樣？

請求會回 402 insufficient_credit 並停止計費。請聯絡管理員加值後即可恢復。

不同 API key 的 credit 會共用嗎？

不會。每把 key 有獨立的餘額，互不影響。這也方便你針對不同整合分別控管用量。

我可以查歷史用量嗎？

系統會將每筆扣點寫入帳本並關聯 request_id。如需用量明細報表，請聯絡你的客戶經理。