Nitro PDF 服務（預覽）

Nitro PDF 服務連接器提供端對端的 PDF 與文件處理：格式間轉換（PDF、Word、Excel、圖片、HTML）、壓縮、合併、分割及編輯檔案（旋轉、刪除頁面、保護/解除保護、扁平化、塗黑）。它們也能從 PDF 中擷取結構化資料與洞察——文字、表格、元資料、表單資料及帶有位置的個人識別資訊——同時支援安全的 API 存取與文件屬性管理。

此連接器適用於以下產品和區域：

Service	Class	區域
Copilot Studio	進階	除以下部分外，所有Power Automate區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government regions - Azure中國地區 - 美國國防部（DoD）
Power Apps	進階	除以下部分外，所有Power Apps區域 - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除以下部分外，所有Power Automate區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	氮氣支援
URL	https://www.gonitro.com/support
Email	prosupport@sfdc.gonitro.com

連接器中繼資料
Publisher	Nitro PDF
網站	https://www.gonitro.com/
隱私策略	https://www.gonitro.com/legal/privacy-policy
類別	生產力;資訊科技營運

Nitro PDF 服務連接器

概觀

Nitro PDF Services 連接器揭示了 Nitro PDF Services API — 一套完整的 PDF 處理功能，讓你能在流程中程式化地轉換、編輯、保護、擷取資料並轉換 PDF 文件。

Publisher：Nitro Software 版本：1.1 發布日期：2026-07-22

此版本的新功能

此版本在先前認證版本之上新增以下功能。前一版本中沒有任何操作被移除，現有流程仍可正常運作，且未做任何變更。

Picker 原生鏈化。 現在，每一個回傳檔案的動作都會在動態內容選擇器中暴露檔案名稱和檔案內容的標記。將它們放入下一個動作的檔案名稱與檔案內容輸入中，進行多步驟流程（例如，將 PDF → PDF 優化為 Word → 浮水印 PDF），無需表達式或手動輸入檔名。
PDF轉PowerPoint。 將 PDF 轉換成可編輯的 PowerPoint.pptx（）簡報。
PDF轉PDF/A。 將標準 PDF 轉換為 ISO 標準化的 PDF/A 檔案格式。支援 8 個符合性層級（1b、1a、2b、2u、2a、3b、3u、3a），因此文件可長期保存，無需外部字型或色彩配置檔依賴。
優化 PDF。 可使用五種指定配置之一來縮小 PDF 檔案大小： Web （線性化以快速網頁傳遞、螢幕解析度降樣）、列印（保留列印解析度影像）、 Archive （為轉換 PDF/A 準備縮小大小）、 最小檔案大小 （積極降樣以取得最小輸出）、以及 混合點陣內容 （MRC 壓縮，將文字與背景圖層分離，最適合掃描頁面）。
浮水印PDF。 將圖片浮水印疊加到PDF的特定頁面上。接受 PNG、JPEG、TIFF、GIF 或 SVG 作為浮水印圖片。
OCR PDF。 對掃描或基於影像的 PDF 應用光學字元辨識，產生可搜尋且可選擇的文字圖層，且不改變文件的視覺外觀。支援英語、德語、法語、西班牙語、義大利語、芬蘭語、瑞典語、丹麥語、挪威語、荷蘭語、葡萄牙語及巴西葡萄牙語（每種請求提供一種語言）。
填寫 PDF 表單。 將欄位值以 JSON、CSV、XFDF 或 FDF 形式填入可填寫的 PDF（AcroForm），並獲得扁平且填充的 PDF。
建立可填寫的表格。 給定一份 PDF 和要建立的表單欄位描述，將這些欄位寫入文件中，作為真正的 AcroForm 並回傳一份可填寫的 PDF。
智慧型態偵測欄位。 分析 PDF 並回傳可填寫表單欄位的位置。輸出可直接匯入「建立可填寫表單」，將非表單文件轉為可填寫表單。
擷取發票資料。 從 PDF 中擷取結構化發票與收據資料——供應商名稱與地址、日期、發票號碼、貨幣、小計、稅項、總額及項目。掃描的發票會透過內建的 OCR 自動處理。
提升輸入體驗。 常見的操作參數現在改為下拉選單，而非自由文字，檔案輸入在每個動作中使用一致的標籤（Word File、Excel File 等）。

先決條件

要使用 Nitro PDF Services 連接器，您需要：

可存取 Nitro PDF 服務 API。此功能目前透過早期存取計畫提供——請於 https://www.gonitro.com/contact-sales/early-access-automate。
訂閱包含目標主機（Microsoft Power Automate、Microsoft Power Apps、Azure Logic Apps或Microsoft Copilot Studio）的高級連接器。

驗證

Nitro PDF Services API 採用機器對機器 OAuth 2.0 並授權客戶憑證（Client Credentials）。

運作原理

使用您的全域管理員憑證登入 Nitro 管理入口 https://admin.gonitro.com 網站。
建立一個 API 應用程式來取得客戶端 ID 和客戶端秘密。
連接器會將這些憑證交換為一個短暫存在的承載存取權杖， https://api.gonitro.dev/oauth/token 並用該憑證授權下游的 API 呼叫。
存取憑證有效期為24小時;連接器會自動快取並刷新這些資料。

詳細的憑證設定步驟可參考 Nitro 認證文件。

正在建立連線

將連接器加入流程或應用程式時：

選擇 新增連線。
輸入 Nitro 用戶端 ID 與 Nitro 用戶端秘密 ，並於 Nitro 管理入口網站中發布。
保留連線。連接器會自動取得並刷新存取權杖。

不需使用者互動式登入。此連線設計用於伺服器間的情境。

API 主機與基底路徑

https://api.gonitro.dev

支援的作業

轉換

在 PDF 與其他文件格式間轉換。

Word 轉 PDF，PDF轉 Word — 從、 .docx、 .docm.dotx.dotm之間轉換。.doc
Excel 轉 PDF，PDF轉 Excel — 從、 .xlsx、 .xlsm、 .xltx.xltm、之間轉換到 .xls。
PowerPoint 轉 PDF，PDF轉 PowerPoint — 可從 .ppt、 .pptx。
影像轉 PDF、 PDF 轉影像 — 支援的影像格式：JPEG、PNG、GIF、TIFF 及 SVG（輸入）;JPEG 和 PNG（輸出）。
HTML 轉 PDF — 也接受 XML、CSV、EPS 及 RTF 作為原始格式。
PDF 轉 PDF/A — 可轉換為 8 個 PDF/A 合規等級中的任一，以進行長期存檔。

轉換預設會回傳一個二進位檔案。若要接收已簽署的儲存 URL，請將 接受（輸出格式） 進階輸入設為 application/json。

轉換

修改或重組現有的 PDF。

優化 PDF — 使用命名設定檔（網頁、列印、歸檔、最小檔案大小或混合點陣內容）來縮小檔案大小。
壓縮 PDF — 無需參數即可減少檔案大小。內部而言，壓縮是優化的一個特例，總是套用最積極的最小檔案大小設定檔;當你只是想要一個較小的 PDF 以便分享或上傳時，可以使用它。
扁平化 PDF ——將互動或分層元素——如形式欄位、註解、數位簽名、圖層與透明片——轉為靜態且不可編輯的內容。這個手術是不可逆的。
旋轉 PDF 頁面 — 依索引逐頁旋轉。支撐角為90度、180度及270度。
刪除 PDF 頁面 — 依 索引移除頁面。
分割 PDF 文件 — 利用自訂頁面範圍將多頁 PDF 拆分成多個 PDF。
合併 PDF 文件 — 將 多個 PDF 合併成一份文件，並依序排列每個原始檔案的頁面。可從來源檔名產生可選的目錄。
浮水印 PDF — 在指定頁面上疊加圖片浮水印。
編輯 PDF 頁面 — 新增遮蔽矩形以隱藏敏感內容。
設定 PDF 屬性 — 更新 PDF 元資料欄位（標題、作者、主題、關鍵字、創作者、製作人）。
密碼保護 PDF — 套用密碼，並透過可選權限（列印、修改、複製、註解、表單、組裝、列印-hq）控制使用者對檔案的操作。
解除保護 PDF — 移除密碼及其相關的權限限制。
OCR PDF — 對掃描或基於影像的 PDF 套用 OCR，並回傳帶有可搜尋、可選擇文字圖層的版本。

轉換預設會回傳一個二進位檔案;同樣適用相同的 application/json Accept-header 開關。

Extract

從 PDF 中擷取結構化或非結構化資料。擷取總是回傳 JSON。

擷取 PDF 表單資料 — 讀取填寫的 AcroForm 欄位值，並回傳每個欄位的名稱、值、類型及位置。
智慧偵測表單欄位 — 偵測尚未有表單的文件中可填寫表單欄位的位置。輸出可直接匯入「建立可填寫表單」。
擷取 PDF 表格資料 — 從 PDF 中偵測並回傳表格內容，包括儲存格、標題、頁腳及每格信心分數。
從 PDF 擷取文字 — 透過參數擷取完整文件文字，或可選擇性地只擷取特定頁面 pageIndices 。
從 PDF 擷取 PII 位置 — 在 PDF 中尋找特定字串並返回其邊界框。
從 PDF 中擷取個人識別資訊（PII ）— 在 PDF 中識別個人可識別資訊（PII），並回傳每次事件的邊界框、類型及信心分數。支援英語與西班牙語。
從 PDF 擷取屬性 — 閱讀 PDF 元資料欄位（標題、作者、主題、關鍵字、創作者、製作者、建立日期、修改日期、陷阱標誌）。
從 PDF 擷取發票資料 — 從 PDF 中擷取結構化發票與收據欄位（供應商、地址、日期、發票號碼、貨幣、小計、稅項、總額、項目）。掃描文件則透過內建的 OCR 處理。

填寫並建立表格

填寫 PDF 表單 — 使用 JSON、CSV、XFDF 或 FDF 格式填入可填寫的 PDF，並收到填寫的 PDF。
建立可填寫表單 — 帶一份 PDF 加上表單欄位的說明，建立並回傳相同的 PDF，欄位以真實的 AcroForm 形式呈現。

流程中的連鎖動作

每次回傳檔案的動作都會在動態內容選擇器中暴露三個回應標記：檔案名稱、檔案內容類型與檔案內容。 若要將一個 Nitro 動作的輸出傳遞到下一個 Nitro 動作的檔案輸入，請將 File Name 置入下一個動作的檔案名稱輸入，並將 File Content 置入其檔案內容輸入。不需要表達式或手動輸入檔名。

預設情況下，動作以同步二進位模式執行。在進階情境下，單一動作可切換為：

儲存 URL 模式 — 將 接受（輸出格式） 進階輸入設定為 application/json。回應會包含已處理檔案的簽名 URL，而非檔案主體。簽名網址的有效期約為15分鐘。
非同步模式 — 將 Prefer 標頭設為 respond-async。回應中包含一個可以另外輪詢的職缺ID。

錯誤與限速

Nitro PDF 服務 API 可回傳以下 HTTP 狀態碼：

400 — 不好的請求。 請求有效載荷或參數無效（例如，密碼保護的輸入 PDF、頁面索引超出範圍，或不支援的浮水印影像格式）。
401 — 未經授權。 存取權杖遺失、過期或形狀異常。
403 — 禁止。 呼叫端沒有要求之作業的許可權。
404 — 未找到。 所請求的資源不存在。
405 — 不允許使用此方法。 端點不允許使用 HTTP 方法。
406 — 不可接受。 標 Accept 頭要求使用不支援的回應格式。
408 — 請求暫停。 這個請求耗時過長，通常是因為網路問題或負載過大。
410 — 消失了。 被參考的檔案不再可用（檔案在其保留期間後會從暫存中移除）。
413 — 內容過大。 上傳的檔案超出了大小限制。
415 — 不支援媒體類型。 該檔案格式不支援所請求的操作。
422 — 無法處理的實體。 這些參數在結構上有效，但無法處理（例如，無效的傳遞指令或端點組不支援的操作）。
429 — 請求太多。 費率超過了上限。回應中包含 retry_after 一個以秒為單位的數值，表示等待多久後再嘗試。
500 — 內部伺服器錯誤。 伺服器端發生了意外錯誤。

月台限制

檔案大小。 每個請求最多可達 100 MB。適用於單檔及多檔操作。
頁數。 每份文件最多可達500頁。多檔案操作總頁數可超過500頁，前提是沒有任何單一文件超過限制。
檔案保留。 儲存在 Nitro 臨時儲存中的輸入與輸出檔案會在操作完成約 15 分鐘後移除。下游簽署的網址也會在此期間過期。
速率限制。 API 會強制每個帳號的速率限制。當達到限制時，API 會回傳帶有 retry_after 回應值的 HTTP 429。

已知問題和限制

檔案必須在 100 MB 以下。 較大的請求會回來 413 — Content Too Large。處理前先拆分大型 PDF。
臨時檔案會在 ~ 15 分鐘內過期。 如果你需要長期保存，請將處理中的檔案持久保存到該視窗內的一個耐用位置（例如 OneDrive、SharePoint 或 S3 儲存桶）。
Storage-URL 和非同步回應標記在選擇器中始終可見。 當動作以預設的同步二進位模式執行時，未使用的 Result、 Job ID、 Job Status和 Job Progress 標記會被解析為 null，可以忽略。
OCR 每個請求處理一種語言。 對於混合語言文件，選擇主導語言或依語言拆分文件。

Notes

轉換、轉換、OCR 及表單操作預設會回傳二進位檔案，並可透過進階輸入切換至 storage-URL 或非同步模式。
擷取操作總是回傳 JSON。

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有地區	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	Required
Nitro 客戶端識別碼	安全字串	您的 Nitro 應用程式客戶端 ID	沒錯
Nitro 客戶端祕密	安全字串	您的 Nitro 應用程式客戶端秘密	沒錯

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

Excel 轉 PDF	將 Excel 工作簿轉換成 PDF 文件，同時保留版面與格式。
HTML 轉 PDF	將 HTML 內容或網頁轉換成 PDF 文件。
OCR PDF 文件	對掃描或圖片為基礎的 PDF 套用 OCR，讓所有文字都能搜尋。
PDF 轉 Excel	將 PDF 文件轉換成可編輯的 Excel 檔案。
PDF 轉 PDFA	將 PDF 文件轉換為 PDF/A 檔案格式以長期保存。 PDF/A 是一個 ISO 標準化的 PDF 子集，嵌入所有字型、色彩配置檔及元資料，以便未來能完全相同地渲染文件，無需外部依賴。
PDF 轉 PowerPoint	將 PDF 文件轉換成可編輯的 PowerPoint 檔案。
PDF 轉 Word	將 PDF 文件轉換成可編輯的 Word 檔案。
PDF轉為圖片	將 PDF 文件的每一頁轉換成圖片檔案。
PowerPoint 轉 PDF	將 PowerPoint 簡報轉換成 PDF 文件。
Unprotected PDF 文件	當提供有效憑證時，請移除 PDF 文件中的密碼保護。
Word 轉 PDF	將 Word 文件轉換成 PDF 檔案，同時保留格式。
優化 PDF 文件	針對特定輸出目標優化 PDF。設定檔：網頁（linearise + downsample 以快速傳送網頁/電子郵件）、列印（保留列印解析度以提升高品質列印）、歸檔（縮小大小並準備 PDF/A 轉換）、最小檔案大小（積極降樣並剔除最小檔案的冗餘資料）、混合點陣內容（MRC 壓縮，將文字與背景圖層分離，最適合掃描文件）。
分割 PDF 文件	根據頁數範圍或單頁，將 PDF 文件拆分成多個檔案。
刪除 PDF 頁面	從 PDF 文件中移除一個或多個指定頁面。
合併 PDF 文件	將多個 PDF 文件合併成一個 PDF 檔案。
圖片轉PDF	將一個或多個影像檔案轉換成單一的 PDF 文件。
填寫 PDF 表單	從資料檔案填寫 PDF AcroForm。提供 PDF 表單範本及一個資料檔案（CSV、JSON、XFDF 或 FDF），將表單欄位名稱對應到數值。填寫好的PDF會被歸還。
壓縮 PDF 文件	壓縮 PDF 以縮小檔案大小。套用固定最小檔案大小設定檔（Optimize 的特例）;若想更細緻地控制大小與品質的權衡，請使用 Optimize 及其設定檔。
密碼保護 PDF 文件	在 PDF 文件中加入密碼保護，以限制存取或編輯。
建立可填寫表格	透過自動新增表單欄位，在 PDF 中建立可填寫的 AcroForm。附有新可填寫表格的 PDF 會被退回。
從 PDF 中擷取所有文字	從 PDF 文件中擷取所有可讀文字內容。
從 PDF 擷取個人資訊	從 PDF 文件中偵測並擷取個人識別資訊（PII）。回傳該 PII 的 PII 值、PII 類別及邊界框位置。可與 Redaction Block 搭配使用，以遮蔽 PDF。
從 PDF 擷取屬性	可取得文件的元資料與屬性，如標題、作者、建立日期及檔案細節。
從 PDF 擷取搜尋的文字	利用文字或正則表達式查詢，識別 PDF 文件中可搜尋文字的位置。回傳每個匹配的邊界框位置資料，依請求順序依查詢群組。
從 PDF 擷取發票資料	從 PDF 文件中擷取結構化發票或收據資料，包括項目、總計、日期及供應商資訊。
扁平化 PDF 文件	將表單欄位和註解轉換為靜態且不可編輯的內容，將 PDF 扁平化。
擷取 PDF 表單資料	從 PDF 文件中擷取表單欄位資料，並可搭配影像化的 PDF 使用。回傳鍵值對、標籤及表單資料。
擷取 PDF 表格資料	從 PDF 文件中擷取表格資料。自動識別檔案中所有資料表，並回傳每個資料表的儲存格、頁首、頁尾及信心分數。
旋轉 PDF 文件	在 PDF 文件中旋轉一個或多個頁面到所需的方向。
智慧偵測表單欄位	偵測 PDF 文件中可填寫表單欄位應放置的位置。回傳偵測到的表單欄位邊界框。
浮水印 PDF 文件	將浮水印圖片疊加到PDF文件的一頁或多頁上。
編輯PDF頁面	永久移除或遮蔽指定內容，顯示部分 PDF 頁面中的內容。
設定 PDF 屬性	更新文件的元資料，如標題、作者、主題或關鍵字。

Excel 轉 PDF

作業識別碼：: ExcelToPDF

將 Excel 工作簿轉換成 PDF 文件，同時保留版面與格式。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
Excel檔案	file	True	file	要轉換的 Excel 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

HTML 轉 PDF

作業識別碼：: HTMLToPDF

將 HTML 內容或網頁轉換成 PDF 文件。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
HTML 檔案	file	True	file	要轉換的 HTML 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

OCR PDF 文件

作業識別碼：: OCRPDFDocument

對掃描或圖片為基礎的 PDF 套用 OCR，讓所有文字都能搜尋。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	用來套用 OCR 的 PDF 檔案
OCR 參數	params		string	可選的 JSON OCR 參數。語言：用於識別的文件語言（「英語」、「德語」、「法語」、「西班牙語」、「義大利語」、「芬蘭語」、「瑞典語」、「丹麥語」、「挪威語」、「荷蘭語」、「葡萄牙語」、「巴西語」;預設為「英語」）。品質：速度與準確度之間的權衡（「低」、「中」、「高」;預設為「高」）。 isOutputPDFEditable：當正確時，識別的文字會被渲染在頁面影像上，使其可編輯;當 false（預設）時，文字會被放置在影像後方，保持視覺外觀。 compressionLevel：對輸出 PDF 施加的壓縮（「低」、「中」、「高」;預設為「低」）。 PDFVersion：輸出檔案的 PDF 規範版本（「pdf14」、「pdf15」、「pdf16」、「pdf17」;預設：「pdf17」）。 pageIndices：用於處理的零基頁面索引（[0,1,...] 或對所有頁面省略）。

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

PDF 轉 Excel

作業識別碼：: PDFToExcel

將 PDF 文件轉換成可編輯的 Excel 檔案。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

PDF 轉 PDFA

作業識別碼：: PDFToPDFA

將 PDF 文件轉換為 PDF/A 檔案格式以長期保存。 PDF/A 是一個 ISO 標準化的 PDF 子集，嵌入所有字型、色彩配置檔及元資料，以便未來能完全相同地渲染文件，無需外部依賴。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案
PDF/A 參數	params	True	string	PDF/A 轉換參數以 JSON 字串形式呈現。必修條件： `to` （必須是「pdfa」）， `conformance` （其中一項：1b、1a、2b、2u、2a、3b、3u、3a）。可選： `imageQuality` （數字，0.01-€“1.0，預設 0.8）， `copyMetadata` （布林值，預設 true）。注意：以（1a/2a/3a）結尾`a`的符合性等級要求將原始 PDF 標籤（邏輯結構樹）;用於`bu`通用歸檔或變體。

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

PDF 轉 PowerPoint

作業識別碼：: PDFToPowerPoint

將 PDF 文件轉換成可編輯的 PowerPoint 檔案。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

PDF 轉 Word

作業識別碼：: PDFToWord

將 PDF 文件轉換成可編輯的 Word 檔案。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

PDF轉為圖片

作業識別碼：: PDFToImage

將 PDF 文件的每一頁轉換成圖片檔案。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
輸出影像格式	to	True	string	每個轉換頁面的圖片格式。
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

PowerPoint 轉 PDF

作業識別碼：: PowerPointToPDF

將 PowerPoint 簡報轉換成 PDF 文件。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PowerPoint 檔案	file	True	file	PowerPoint 檔案要轉換

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

Unprotected PDF 文件

作業識別碼：: UnprotectPDFDocument

當提供有效憑證時，請移除 PDF 文件中的密碼保護。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案
無保護參數	params	True	string	格式 {“ownerPassword”： “owner-secret”， “userPassword”： “user-secret”}

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

Word 轉 PDF

作業識別碼：: WordToPDF

將 Word 文件轉換成 PDF 檔案，同時保留格式。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
Word 檔案	file	True	file	要轉換的 Word 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

優化 PDF 文件

作業識別碼：: OptimizePDFDocument

針對特定輸出目標優化 PDF。設定檔：網頁（linearise + downsample 以快速傳送網頁/電子郵件）、列印（保留列印解析度以提升高品質列印）、歸檔（縮小大小並準備 PDF/A 轉換）、最小檔案大小（積極降樣並剔除最小檔案的冗餘資料）、混合點陣內容（MRC 壓縮，將文字與背景圖層分離，最適合掃描文件）。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
優化配置檔	profile	True	string	根據目標輸出來選擇。 `web` ♬」快速觀看與較小的尺寸。 `print` ♬」保存印刷影像。 `archive` 「準備檔案以進行 PDF/A 轉換。 `minimal-file-size` ♪ 積極壓縮。 `mixed-raster-content` ♬ MRC 壓縮，最適合掃描文字與圖片混合的頁面。
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

分割 PDF 文件

作業識別碼：: SplitPDFDocument

根據頁數範圍或單頁，將 PDF 文件拆分成多個檔案。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案
頁面	params	True	string	格式 {“pageIndice”：[[0,2]，[1,3,4]]}

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

刪除 PDF 頁面

作業識別碼：: DeletePDFPages

從 PDF 文件中移除一個或多個指定頁面。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案
刪除頁面	params	True	string	格式 {“pageIndices”：[0,2]}

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

合併 PDF 文件

作業識別碼：: MergePDFDocuments

將多個 PDF 文件合併成一個 PDF 檔案。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
檔案 1	file1	True	file	PDF 檔案內容合併（1）
檔案 2	file2	True	file	PDF 檔案內容可合併（2）
檔案 3	file3		file	PDF 檔案內容以合併（3）
檔案 4	file4		file	PDF 檔案內容合併（4）
檔案 5	file5		file	PDF 檔案內容合併（5）
檔案6	file6		file	PDF 檔案內容以合併（6）
檔案7	file7		file	PDF 檔案內容以合併（7）
檔案8	file8		file	PDF 檔案內容合併（8）
選項（JSON）	params		string	可選的 JSON 選項。說明：「tableOfContents」â€ 控制合併後 PDF 前的目錄頁，例如 {“tableOfContents”：{“enabled”：true}}。「啟用」預設為 true;將它設為 false 以合併時不產生目錄頁面。

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

圖片轉PDF

作業識別碼：: ImageToPDF

將一個或多個影像檔案轉換成單一的 PDF 文件。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
影像檔案	file	True	file	要轉換的影像檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

填寫 PDF 表單

作業識別碼：: FillPDFForm

從資料檔案填寫 PDF AcroForm。提供 PDF 表單範本及一個資料檔案（CSV、JSON、XFDF 或 FDF），將表單欄位名稱對應到數值。填寫好的PDF會被歸還。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF 表單範本	file	True	file	填寫 PDF AcroForm 範本。必須先提交。
表單資料檔案（CSV、JSON、XFDF 或 FDF）	dataFile		file	資料檔案將欄位名稱映射為數值。支援 CSV、JSON、XFDF 或 FDF。 JSON 格式：欄位/值物件的清單，例如 [{“field”：“name”，“value”：“x”}，{“field”：address“，”value“：”y“}]。每個項目都需要一個「欄位」（欄位名稱）和一個「值」（字串、數字、布林值或空值）。 XFDF 和 FDF 是標準的 Adobe 表單資料檔案，從 PDF 工具匯出而成。可選：你可以透過 Options（JSON）欄位的「fields」鍵，內嵌提供這些值，取代檔案。
選項（JSON）	params		string	可選的 JSON 選項。鍵值：「嚴格」（布林）â€ 當要求為真、未知或缺失時（422）;當錯誤（預設）時，這些問題會被忽略。「欄位」 â€ 內嵌欄位值作為上傳資料檔案的替代方案，例如 {“fields”：[{“field”：“name”，“value”：x“}，{”field“：”address“，”value“：”y“}]}。提供表單資料檔或內嵌「欄位」。

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

壓縮 PDF 文件

作業識別碼：: CompressPDFDocument

壓縮 PDF 以縮小檔案大小。套用固定最小檔案大小設定檔（Optimize 的特例）;若想更細緻地控制大小與品質的權衡，請使用 Optimize 及其設定檔。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

密碼保護 PDF 文件

作業識別碼：: PasswordProtectPDFDocument

在 PDF 文件中加入密碼保護，以限制存取或編輯。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案
保護參數	params	True	string	格式 {“ownerPredentials”：owner-secret“， ”userPassword“： ”user-secret“， ”permissions“： [ ”print“， ”copy“ ] }

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

建立可填寫表格

作業識別碼：: CreateFillableForms

透過自動新增表單欄位，在 PDF 中建立可填寫的 AcroForm。附有新可填寫表格的 PDF 會被退回。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	PDF 檔案將轉成可填寫的表格。
表單欄位（JSON）	params	True	string	JSON 描述表單欄位，以建立「智慧偵測表單欄位」動作的輸出。 Shape： {“formFields”：[{“pageIndex”：0，“fieldType”：“TextBox”\|”CheckBox“，”name“：”FirstName“，”boundingBox“：[x，y，width，height]，”value“：optional”}]}。

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

從 PDF 中擷取所有文字

作業識別碼：: ExtractTextFromPDF

從 PDF 文件中擷取所有可讀文字內容。

參數

名稱	機碼	必要	類型	Description
PDF檔案	file	True	file	要處理的 PDF 檔案
萃取參數	params		string	可選的 JSON 物件。欄位：pageIndices（整數陣列，例如 [0,2];完整文件省略）及 readingOrder（布林值，預設 false;為視覺閱讀流程重新排序文字）。

傳回

名稱	路徑	類型	Description
結果	result	string	JSON 結果

從 PDF 擷取個人資訊

作業識別碼：: ExtractPIIFromPDF

從 PDF 文件中偵測並擷取個人識別資訊（PII）。回傳該 PII 的 PII 值、PII 類別及邊界框位置。可與 Redaction Block 搭配使用，以遮蔽 PDF。

參數

名稱	機碼	必要	類型	Description
文件語言	language	True	string	PDF 文本語言用於識別識別資訊（PII）偵測。
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
PIIBox	result.PIIBoxes	array of object	PIIBox
ID	result.PIIBoxes.ID	string	ID
收發簡訊	result.PIIBoxes.text	string	收發簡訊
textPiece	result.PIIBoxes.textPiece	string	textPiece
頁面索引	result.PIIBoxes.pageIndex	integer	頁面索引
邊界框	result.PIIBoxes.boundingBox	array of number	邊界框
PIIType	result.PIIBoxes.PIIType	string	PIIType
信賴度	result.PIIBoxes.confidence	float	信賴度

從 PDF 擷取屬性

作業識別碼：: ExtractPropertiesFromPDF

可取得文件的元資料與屬性，如標題、作者、建立日期及檔案細節。

參數

名稱	機碼	必要	類型	Description
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
title	result.title	string	title
作者	result.author	string	作者
主旨	result.subject	string	主旨
關鍵字	result.keywords	string	關鍵字
建立者	result.creator	string	建立者
製作人	result.producer	string	製作人
創建日期	result.creationDate	string	創建日期
模組日期	result.modDate	string	模組日期
被困住了	result.trapped	string	被困住了

從 PDF 擷取搜尋的文字

作業識別碼：: ExtractPIILocationFromPDF

利用文字或正則表達式查詢，識別 PDF 文件中可搜尋文字的位置。回傳每個匹配的邊界框位置資料，依請求順序依查詢群組。

參數

名稱	機碼	必要	類型	Description
查詢查詢	params	True	string	格式 {“queries”： [{“text”： “Name”}， {“text”： “tax id： [0-9]+”， “isRegex”： true， “regexFlags”： [“ignore-case”]}}}. 每個查詢預設為文字;將 isRegex 設為 true，以匹配為正則表達式。可選的正則表達式旗標（僅限正則表達式查詢）：忽略大小寫、多行、點全。
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
textBoxes	result.textBoxes	array of object	textBoxes
收發簡訊	result.textBoxes.query.text	string	收發簡訊
isRegex	result.textBoxes.query.isRegex	boolean	isRegex
正則表示旗	result.textBoxes.query.regexFlags	array of string	正則表示旗
比賽	result.textBoxes.matches	array of object	比賽
匹配文字	result.textBoxes.matches.matchedText	string	匹配文字
盒子	result.textBoxes.matches.boxes	array of object	盒子
頁面索引	result.textBoxes.matches.boxes.pageIndex	integer	頁面索引
邊界框	result.textBoxes.matches.boxes.boundingBox	array of number	boundingBox [x， y， width， height]
textPiece	result.textBoxes.matches.boxes.textPiece	string	textPiece
groups	result.textBoxes.matches.groups	array of object	groups
索引	result.textBoxes.matches.groups.index	integer	索引
收發簡訊	result.textBoxes.matches.groups.text	string	收發簡訊
盒子	result.textBoxes.matches.groups.boxes	array of object	盒子
頁面索引	result.textBoxes.matches.groups.boxes.pageIndex	integer	頁面索引
邊界框	result.textBoxes.matches.groups.boxes.boundingBox	array of number	boundingBox [x， y， width， height]
textPiece	result.textBoxes.matches.groups.boxes.textPiece	string	textPiece

從 PDF 擷取發票資料

作業識別碼：: ExtractInvoiceDataFromPDF

從 PDF 文件中擷取結構化發票或收據資料，包括項目、總計、日期及供應商資訊。

參數

名稱	機碼	必要	類型	Description
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
費用文件	result.expenseDocuments	array of object	費用文件
summary欄位	result.expenseDocuments.summaryFields	array of object	summary欄位
型別	result.expenseDocuments.summaryFields.type	string	型別
value	result.expenseDocuments.summaryFields.value	string	value
信賴度	result.expenseDocuments.summaryFields.confidence	float	信賴度
pageNumber	result.expenseDocuments.summaryFields.pageNumber	integer	pageNumber
貨幣	result.expenseDocuments.summaryFields.currency	string	貨幣
摘要群組	result.expenseDocuments.summaryGroups	array of object	摘要群組
groupType	result.expenseDocuments.summaryGroups.groupType	string	groupType
領域	result.expenseDocuments.summaryGroups.fields	array of object	領域
型別	result.expenseDocuments.summaryGroups.fields.type	string	型別
value	result.expenseDocuments.summaryGroups.fields.value	string	value
信賴度	result.expenseDocuments.summaryGroups.fields.confidence	float	信賴度
pageNumber	result.expenseDocuments.summaryGroups.fields.pageNumber	integer	pageNumber
行項目群組	result.expenseDocuments.lineItemGroups	array of object	行項目群組
lineItems	result.expenseDocuments.lineItemGroups.lineItems	array of object	lineItems
領域	result.expenseDocuments.lineItemGroups.lineItems.fields	array of object	領域
型別	result.expenseDocuments.lineItemGroups.lineItems.fields.type	string	型別
value	result.expenseDocuments.lineItemGroups.lineItems.fields.value	string	value
信賴度	result.expenseDocuments.lineItemGroups.lineItems.fields.confidence	float	信賴度
pageNumber	result.expenseDocuments.lineItemGroups.lineItems.fields.pageNumber	integer	pageNumber

扁平化 PDF 文件

作業識別碼：: FlattenPDFDocument

將表單欄位和註解轉換為靜態且不可編輯的內容，將 PDF 扁平化。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

擷取 PDF 表單資料

作業識別碼：: ExtractPDFFormData

從 PDF 文件中擷取表單欄位資料，並可搭配影像化的 PDF 使用。回傳鍵值對、標籤及表單資料。

參數

名稱	機碼	必要	類型	Description
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
領域	result.fields	array of object	領域
欄位名稱	result.fields.name	string	表單欄位名稱
欄位值	result.fields.value	string	表態欄位值
場信心	result.fields.confidence	float	形式場信心
平均信心	result.averageConfidence	float	平均信心

擷取 PDF 表格資料

作業識別碼：: ExtractPDFTableData

從 PDF 文件中擷取表格資料。自動識別檔案中所有資料表，並回傳每個資料表的儲存格、頁首、頁尾及信心分數。

參數

名稱	機碼	必要	類型	Description
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
formFields	result.formFields	array of object	偵測到的表單欄位
頁面索引	result.formFields.pageIndex	integer	欄位所在的零基頁面索引
fieldType	result.formFields.fieldType	string	文字方塊或勾選框
名字	result.formFields.name	string	偵測到的表單欄位名稱
邊界框	result.formFields.boundingBox	array of float	以 PDF 點表示的邊界框 [x， y， width， height]
value	result.formFields.value	string	初始欄位值

旋轉 PDF 文件

作業識別碼：: RotatePDFDocuments

在 PDF 文件中旋轉一個或多個頁面到所需的方向。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	要處理的 PDF 檔案
順時針旋轉頁面	params	True	string	格式 {“rotations”：[{“page_index”： 0，“amount”： 90}]}

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

智慧偵測表單欄位

作業識別碼：: SmartDetectFormFields

偵測 PDF 文件中可填寫表單欄位應放置的位置。回傳偵測到的表單欄位邊界框。

參數

名稱	機碼	必要	類型	Description
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
領域	result.fields	array of object	領域
欄位名稱	result.fields.name	string	偵測到的表單欄位名稱
fieldType	result.fields.type	string	偵測到的形態欄位類型
頁面索引	result.fields.pageIndex	integer	以零為基礎的頁面索引，該欄位被偵測到
邊界框	result.fields.boundingBox	array of float	以 PDF 點表示的邊界框 [x0，y0，x1，y1]
場信心	result.fields.confidence	float	偵測信心

浮水印 PDF 文件

作業識別碼：: WatermarkPDFDocument

將浮水印圖片疊加到PDF文件的一頁或多頁上。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
PDF檔案	file	True	file	PDF檔案需先加浮水印
浮水印圖片	watermarkFile	True	file	浮水印圖片可疊加到 PDF 上（支援格式：PNG、JPEG、TIFF、GIF、SVG）
浮水印參數	params	True	string	JSON 浮水印參數。必填：boundingBox （[x0，y0，x1，y1] 以 PDF 點表示，例如 [210,10,290,60]） â€“ 僅在 fitToPageWidth 與 fitToPageHeight 皆為真時省略。可選選項：不透明度（0.0⁵“1.0，預設 1.0）、旋轉（度數，預設 0.0）、pageIndices（[0,1,...] 或所有頁面省略）、contentDepth（「above_existing」或「below_existing」，預設「below_existing」）、fitToPageWidth（布爾）、fitToPageHeight（布爾）、centerOnPage（布爾）、rotateWithPage（布爾）、翻轉（「水平」、「垂直」或「兩者」）。

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

編輯PDF頁面

作業識別碼：: RedactPDFPages

永久移除或遮蔽指定內容，顯示部分 PDF 頁面中的內容。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
屬性	params	True	string	格式 {“redactions”：[{“pageIndex”： 0，“boundingBox”：[100,100,200,120]}，{“pageIndex”： 1，“boundingBox”：[50,50,150,70]}]}
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

設定 PDF 屬性

作業識別碼：: SetPDFProperties

更新文件的元資料，如標題、作者、主題或關鍵字。

參數

名稱	機碼	必要	類型	Description
接受（輸出格式）	Accept		string	例如 application/json
屬性	params	True	string	格式 {“title”：「我的文件標題」、「作者」：「John Doe」、「主題」：「一個有趣的主題」、「關鍵字」：「範例、PDF、元資料」、「創作者」：「Doe John」、「producer」：「Nitro PDF」}
PDF檔案	file	True	file	要處理的 PDF 檔案

傳回

名稱	路徑	類型	Description
檔案名稱	fileName	string	結果的檔名（僅在接受時填充 â€“ 字節模式：application/octet-stream）。將此輸入到下一個串連的 Nitro 動作的檔案名稱輸入中。
檔案內容類型	fileContentType	string	檔案的 MIME 內容類型（僅限位元組模式 â€」，例如 application/pdf）。
檔案內容	fileContent	byte	Base64 編碼的檔案位元組（僅限位元組模式）。將此輸入到下一個串接的 Nitro 動作的檔案內容輸入中 â€」 Power Automate 在轉發到`type: file`插槽時解碼 base64。
檔案	result.file	FileLinkResponse	檔案參考資料
作業識別碼	jobID	string	以非同步模式填充（偏好：回應非同步）。
職務狀態	status	string	工作狀態（非同步模式）。
工作進展	progress	number	工作進度 0.0-1.0（非同步模式）。

定義

FileLink回應

檔案參考資料

名稱	路徑	類型	Description
URL	URL	string	URL
檔案大小位元組	metadata.fileSizeBytes	integer	檔案大小位元組
頁數	metadata.pageCount	integer	頁數