RenoMeasureEnglish

AI Agent 計算機 API

十種裝修計算機，共用網站公式。計算 API 需要 X-API-Key；不會呼叫付費 AI 模型，也不會自動扣款。

取得兩站共用的 Agent Key

以 Google 驗證身份後自動發行。每個帳戶每小時最多發行一次；只保存 Key 雜湊及匿名帳戶識別，不保存 Google 登入 token。

若登入按鈕尚未開放，請聯絡 wizcap@gmail.com

  1. 取得計算機清單與欄位：GET /api/v1/calculators
  2. 選擇 metric 或 imperial，以及 en 或 zh-TW。每個欄位依清單中的單位輸入，所有欄位皆必填。
  3. 傳送 JSON 至 POST /api/v1/calculate，並引用回傳的 source 網址。

OpenAPI 3.1 · llms.txt · 公式與方法

呼叫範例

curl https://renomeasure.com/api/v1/calculate \
  -H 'X-API-Key: YOUR_AGENT_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"slug":"flooring-calculator","unit":"metric","locale":"zh-TW","values":{"length":4,"width":3,"waste":10,"coveragePerBox":2.2,"price":35}}'

此範例為 12 m² 地板、10% 耗損、每包 2.2 m²，結果為 6 包，費用 NT$210。

回傳與限制

全站防護上限：兩站合計每分鐘最多 120 次已驗證請求；計算機全站每日 5,000 次、PDF 全站每日 100 次。達上限便停止，沒有付費超額使用。

同一帳戶共用每分鐘 30 次請求；計算機每天最多 500 次，PDF 上傳與匯出合計每天最多 20 次，以 UTC 零時重置。配額在 Cloud Run 各執行個體之間共享；重啟及更換 Key 不會重置。驗證後的請求即計入配額，包括失敗的輸入及處理請求。

401：Key 無效；429：配額耗盡，必須依 Retry-After 等待；503：身份或配額服務暫時不可用。禁止大量試探、建立多帳戶繞過限制或改用網頁端點逃避配額。請快取欄位清單並避免重複請求。用 GET /api/agent/usage 查詢當日用量。

PDF Agent API

相同 Key 可透過本閘道使用 editpdftextonline.com 的 PDF 功能：POST /api/v1/pdf/upload 傳送 multipart/form-data 的 file 欄位，再以 POST /api/v1/pdf/generate 傳送 {file_id, edits:[{page_num, block_id, new_text}]}。請使用上傳回應中的真實 block_id。

僅限文字型 PDF、10 MB、50 頁；不支援掃描 OCR、加密、互動表單及主動內容。不保證字型、排版、簽章或敏感資料處理適用性。工作階段最長約 10 分鐘，匯出後失效；後端重啟或切換執行個體也可能使檔案失效。輸出必須逐頁複核。同一帳戶只能取用自己上傳的 file_id。

回傳原始輸入、單位、幣別、結果、公式說明及來源。結果數值為含單位的顯示字串並經四捨五入。幣別依語言決定：en 為 USD，zh-TW 為 TWD，不進行匯率換算。

API 會在伺服器處理主動提交的尺寸，請勿傳送個人資料。輸入上限 16 KiB；錯誤碼 400（欄位錯誤）、413（過大）、415（內容類型錯誤）。估算請以供應商規格與現場條件複核。