限制與配額

請求、分頁與輸入欄位的限制。

下列為平台層級限制與方案型額度。固定限制適用於所有 API key；RPS、Burst 與 Credit 配額則依方案設定而定。

分頁

項目	值
limit 預設	20
limit 上限	1000
超過上限	回 400 bad_request（不截斷）

限流與方案配額

項目	說明
維度	每 API key + 端點
RPS	每秒請求數，依方案
Burst	突發容量，依方案
超量行為	reject（回 429）或 wait（排隊）

詳見限流。

Credit 計費

項目	說明
計費時機	僅成功回應（HTTP 2xx）扣 Credit
餘額不足	回 402 insufficient_credit
每月配額	依方案 monthly_credit_quota
餘額回傳	成功回應會帶 X-Credit-Cost 與 X-Credit-Remaining

輸入欄位限制

欄位	限制
Webhook target_url	須以 http:// 或 https:// 開頭，長度 ≤ 2048
Webhook event_type	1–64 字元
X-Request-Id（自帶）	≤ 128 字元，僅限英數、-、_

請求限制

項目	說明
請求逾時	超過處理時間上限時，回 HTTP 408（此回應由基礎設施層產生，不帶 {error} 信封）
請求主體大小	超過大小上限時，回 HTTP 413（同上，不帶 {error} 信封）

逾時與主體大小上限可依部署環境設定，正式環境的實際值請洽你的客戶經理。