用量額度與限制

Bannerify 限制兩件事：你的工作區每月生成多少個檔案，以及單一 API 金鑰在短時間內傳送多少請求。本頁涵蓋這兩項限制、哪些情況會計為一次生成，以及請求遭到拒絕時該怎麼做。

生成次數上限

每個方案都有每月上限，Free 方案另有每日上限。

方案	每月	每天
Free	100	10
Automate	3,000 或 10,000	沒有每日上限
Scale	20,000 或 40,000	沒有每日上限
Enterprise	100,000、500,000 或 1,000,000	沒有每日上限

Free 的上限適用於個人工作區。Free 方案的團隊工作區無法生成檔案，這也是每個新的團隊工作區都從為期 14 天的 Automate 3k 試用開始的原因。試用的說明請見帳單。

兩項上限都以 UTC 時間重設。每日上限在 UTC 00:00 重設，每月上限則在每個 UTC 月份的第一天重設。不會有超額收費。達到上限後，請求會停止，直到下次重設或你升級為止。

Billing & Usage 會顯示你本月已使用的生成次數，側邊欄的 Usage 下方也會顯示相同的次數。

哪些情況會計為一次生成

Bannerify 繪製完檔案後會計為一次生成；若是儲存的檔案，則在上傳完成後才計算。繪製或上傳失敗時不會計算。

請求	是否計算
createImage 和 createPdf	是
createStoredImage 和 createStoredPdf	是
繪製新圖片的簽署網址	是
從快取提供的簽署網址	否
MCP 工具 create_image、create_pdf 和 create_image_from_shapes	是
CLI 的 create image 和 create pdf	是
Zapier、n8n 和 Notion 的繪製	是
嵌入式編輯器中的下載，以及 embed SDK 的 requestContent	是
範本清單、範本詳細資料和專案資訊	否
失敗的繪製或上傳，或遭 Bannerify 拒絕的請求	否

達到上限時

API 會回傳錯誤碼 USAGE_EXCEEDED。訊息會指出你達到的是哪一項上限，例如 You have exceeded your monthly usage limit (100)。請讀取 error.code 來偵測這個錯誤，因為 HTTP 狀態碼是 500，其他錯誤也使用這個狀態碼。

你可以等到下次重設、升級方案，或是在 Enterprise 需要更高上限時，寫信到 an@bannerify.co。

CLI、MCP 伺服器和免寫程式整合也會顯示相同的錯誤。

速率限制

每個 API 金鑰每 10 秒最多可以傳送 100 個請求。計數是依端點群組分開計算，因此某一組的大量請求不會用掉另一組的額度。

群組	共用同一個計數器的端點	超過限制時的錯誤碼
圖片	createImage	RATE_LIMITED
簽署網址	signedurl	RATE_LIMITED
PDF 與儲存的圖片	createPdf 和 createStoredImage	TOO_MANY_REQUESTS
儲存的 PDF	createStoredPdf	TOO_MANY_REQUESTS

info、範本清單和範本詳細資料這三個端點沒有速率限制。

計數器以固定的 10 秒為一個時段，新時段會從零開始。createImage、createPdf 和簽署網址的回應會帶有兩個標頭：

標頭	值
RateLimit-Remaining	目前時段剩餘的請求數
RateLimit-Reset	時段結束的時間，以毫秒為單位的 Unix 時間戳記

錯誤訊息也會重複說明重設時間。請等到那個時間，再重新傳送請求。進行大量作業時，請限制同時進行的請求數量，並在稍等一下後重試，而不是不斷快速重試。

若要提高某個金鑰的上限，請寫信到 an@bannerify.co。

簽署網址快取

Bannerify 會將簽署網址背後的圖片快取最多 7 天，快取命中不會計為一次生成。快取的運作方式與略過快取的方法，請見簽署網址。

不要超出用量額度

• 把結果儲存一次，之後重複使用它的網址。對於電子郵件或靜態頁面，請只呼叫一次 createStoredImage，並保留回傳的網址，而不是每次瀏覽都重新繪製。
• 相同的資料請重複使用相同的簽署網址。每次瀏覽頁面都產生新網址，就會每次都重新繪製。
• 開始大量批次作業之前，請先查看 Billing & Usage。