Nhảy đến nội dung
Tổng quan Tổng quan Tin tức Tin tức
Chia sẻ

Cookbook

Prompt để sao chép. Các ví dụ API hoàn chỉnh.

28 prompt cho Tài liệu AI, Dữ liệu APIs và quy trình làm việc IDE — sao chép, dán, nhận mã.

llms.txt của PaperOffice đọc bởi mọi LLM hiện đại: Claude, Cursor và IDE của bạn sẽ xử lý phần còn lại.

28 prompt hoàn chỉnh Điểm cuối thực REST và MCP

Tích hợp

Từ llms.txt đến tích hợp liên tục

Ba bước: Liên kết tài liệu, nêu ý định, sao chép mã.

  1. Chèn llms.txt

    Dán vào Claude, Cursor hoặc IDE của bạn.

  2. Nói ý định

    Cần xây dựng gì — hoặc một prompt từ trang này.

  3. Yêu cầu viết mã

    IDE cung cấp tích hợp liên tục.

Document AI

Đọc, kiểm tra và gửi tài liệu

Sao chép prompt, dán vào Claude hoặc Cursor — xong.

IDP Hóa đơn + AI-OCR + Bounding Boxes

Trích xuất các trường hóa đơn bao gồm vị trí trong tài liệu.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build me an invoice extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=invoice, processing_lane=instant (sync)
3. Reads every field from result.pages_idp[0].suggested_fields
   (keys like _supplier_name, _total_amount, _invoice_date)
   and the boxes from result.pages_aiocr.pages
4. Renders a verification view highlighting each value
   at its bounding box position

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI-OCR — Trích xuất văn bản từ hình ảnh/PDF

Toàn văn qua POST /job/add/paperoffice_aiocr___generate (ocr_mode=complete).

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Write a minimal script that:
1. Sends an image or PDF to POST /job/add/paperoffice_aiocr___generate
   (multipart, field file_1)
2. Uses ocr_mode=complete and processing_lane=instant (sync)
3. Prints the extracted text from result ?? job_result (pages)

Modes: complete (+tables), grid (+bounding boxes), text (plain).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI Tách PDF — Tách PDF tổng hợp

Nhận diện ranh giới tài liệu và đặt tên cho từng tệp riêng lẻ.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a splitter for large batch PDFs (up to 3000 pages):
1. POST /job/add/workflow with template=pdf_ai_split (multipart, field file)
2. naming_instruction=Dokumenttyp_Datum_Absender,
   locale=de_DE, processing_lane=instant
3. List every created document from the result
   (suggested filename + page range)

The AI detects document boundaries automatically.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Ẩn danh Tài liệu — Che thông tin PII

Nhận diện và biên tập tên, IBAN, địa chỉ.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt
Also use llms-full.txt for anonymize parameters (scenario, apply).

Build a GDPR anonymizer (preview → apply):
1. POST /job/add/workflow template=document_anonymize_preview (field file)
2. Set scenario=gdpr_auskunft (or externe_weitergabe / finanzdaten),
   redact_categories=all, optional whitelist / custom_redact
3. client_wait=false then poll GET /job/get/{job_id}
4. Show detected_pii.redact_box_ids + simplified_boxes
5. Apply: POST /job/add/paperoffice_dataripper___redact_image
   with files + bounding_boxes + redact_boxes from the preview
   (or MCP: po_anonymization_pii_detect → po_anonymization_redaction_apply
   with preview_job_id)
Optional one-shot: REST template=document_anonymize OR MCP po_anonymization_anonymize
  (no HITL; pass scenario/whitelist).
Redact Agent: POST /documents/redact-agent-run or MCP po_documents_redact_agent_run.

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Voice TTS — Chuyển văn bản thành âm thanh

MP3 đồng bộ qua voice=Nadja (và các giọng khác).

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a text-to-speech generator:
1. POST /job/add/paperoffice_voice___tts with text=..., voice=Nadja,
   output_format=mp3
2. output=url and processing_lane=instant for a synchronous audio link
3. Play or download the audio URL from result ?? job_result

Voices: Nadja, Thomas, Anna, Hans (DE) + 100+ more.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP Hợp đồng + AI-OCR + Bounding Boxes

Trích xuất các trường hợp đồng bao gồm vị trí trong tài liệu.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=contract, processing_lane=instant (sync)
3. Reads parties, dates and notice period from
   result.pages_idp[0].suggested_fields (value + bounding box)
4. Renders a verification view with bounding boxes

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Chữ ký điện tử — Tạo yêu cầu chữ ký

Mời người ký và kiểm soát trạng thái/thông báo nhắc nhở.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an e-signature request flow:
1. Ensure the document has a pofid in PaperOffice
2. POST /signatures/create with document_pofid (or pofid)
   and a signers array (name + email per signer)
3. Return the signature request id and status
4. Optionally POST /signatures/remind for pending signers

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Gửi thư bảo đảm kỹ thuật số — Qua email

Giao hàng an toàn với mật khẩu PDF (qua email hoặc SMS) và nhật ký gửi.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a secure document delivery (digital registered mail):
1. POST /document_delivery/create_and_send with:
   pofids: ["POFID_HERE"],
   recipient_email, optional recipient_name,
   subject, optional message
2. security_mode=link → PDF password in the same email
   security_mode=secure_sms → link by email, password by SMS
   (requires recipient_phone in E.164, e.g. +49170…)
3. Show delivery_id and that access events are logged
   (Versandhistorie / delivery log)

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Dữ liệu & Bảo mật APIs

Kiểm tra vị trí, rủi ro và dữ liệu gốc

Geocoding, thời tiết, dấu vân tay, mã số VAT và hơn thế nữa — dưới dạng lời nhắc.

Geocoding — Chuyển đổi thuận/nghịch / Tự động hoàn thành

Địa chỉ ↔ Tọa độ.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a geocoding helper that:
1. Forward: GET /geocoding/forward?q=...&lang=de
2. Reverse: GET /geocoding/reverse?lat=...&lon=...
3. Autocomplete: GET /geocoding/autocomplete?q=...
4. Prints display_name, lat, lon and credits_billed

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Thời tiết — Hiện tại + Chất lượng không khí

Thời tiết hiện tại bao gồm thanh toán.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a weather lookup that:
1. Calls GET /weather/current?lat=...&lon=...&lang=de
2. Shows temperature, condition text and air quality if present
3. Displays credits_billed from the response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IP2Location — IP → Vị trí

Vị trí từ IP, tùy chọn Thời tiết.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an IP intelligence client that:
1. Calls GET /ip2location/full (empty ip = visitor IP)
2. Extracts country, city, geo_lat/lon, ISP
3. Optionally chains weather from the same response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Dấu vân tay thiết bị — ID khách truy cập

ID khách truy cập và Độ tin cậy.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a device fingerprint check that:
1. Collects client signals in the browser
2. POSTs to /fingerprint/identify
3. Returns visitor_id / confidence for fraud checks

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Bộ phát hiện Email giả — Kiểm tra email tạm thời

Email tạm thời và Điểm rủi ro.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an email risk checker that:
1. Validates an address via the Fake Email Detector endpoint
2. Flags disposable / role / invalid domains
3. Returns a clear allow/deny recommendation

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Kiểm tra VPN / Ẩn danh

VPN, Proxy, Tor, Trung tâm dữ liệu.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VPN/proxy detector that:
1. Calls GET /ip2location/vpn?ip=...
2. Normalizes is_vpn, is_proxy, is_tor, is_datacenter flags
3. Shows a clear risk badge for the visitor

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Trình xác thực VAT — Mã số thuế EU USt-IdNr.

Tính hợp lệ và Dữ liệu doanh nghiệp.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VAT ID validator that:
1. Checks an EU VAT number via the VAT validator endpoint
2. Returns company name and address when valid
3. Handles invalid / not-found responses cleanly

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Chuyển đổi tiền tệ — Tỷ giá trực tiếp

Quy đổi với tỷ giá hiện tại.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a currency converter that:
1. Calls the currency exchange endpoint (from, to, amount)
2. Shows rate and converted amount
3. Caches the last rate for the UI

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDE & Công cụ AI

Dành cho Claude, Cursor và IDE của bạn

Các lệnh prompt hoạt động trong IDE — bao gồm máy chủ MCP.

Hàng đợi hóa đơn IDP + Khung tọa độ + CSV

Trích xuất hàng loạt với tọa độ xác minh.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a Python script that:
1. Takes a folder of invoice PDFs
2. Extracts all fields using POST /job/add/workflow with idp_collection=invoice
3. Returns bounding boxes for verification (result.pages_aiocr)
4. Exports to CSV

Important: Use file_1 for uploads; fields live in result.pages_idp[0].suggested_fields.
Handle sync (HTTP 200 with result) and async (HTTP 202 → poll GET /job/get/{job_id}).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Máy chủ MCP — AI Tài liệu trong IDE

Kết nối MCP và xử lý tài liệu từ không gian làm việc.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Help me set up the MCP Server for PaperOffice in Cursor.
I want to use Document AI directly in my IDE.

Show me:
1. How to configure the MCP connection (URL https://mcp.paperoffice.ai/cursor)
2. Available tools via tools/list
3. How to process documents from my workspace

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Đại lý giọng nói — STT + TTS

Xử lý đầu vào giọng nói và trả lời bằng âm thanh.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a voice agent that:
1. Takes audio input (Speech-to-Text)
2. Processes the text
3. Generates audio response (Text-to-Speech)

Use these pipelines:
- STT: POST /job/add/paperoffice_voice___stt (audio_file)
- TTS: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
  output_format=mp3, output=url)
- Use processing_lane=instant for a synchronous response.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Phát hiện gian lận — Dấu vân tay thiết bị + IP

Kiểm tra dấu vân tay thiết bị và tín hiệu Geo/IP.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a fraud detection system that:
1. Checks device fingerprints
2. Validates IP geolocation
3. Detects suspicious patterns

Use the Security & Data AI endpoints.
These are instant APIs (no polling needed).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Chia nhỏ PDF AI hàng loạt

Chia nhỏ bất đồng bộ các thư mục chứa file PDF lớn.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a batch processor that:
1. Takes a folder of large PDFs (up to 3000 pages each)
2. Uses POST /job/add/workflow with template=pdf_ai_split
3. Uses naming_instruction for smart filenames
4. Handles async jobs (HTTP 202) by polling GET /job/get/{job_id}

Use locale=de_DE for German document types.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Bộ phân loại tài liệu — OCR + Thư mục

OCR, phân loại và sắp xếp vào các thư mục con.

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document classifier that:
1. Watches a folder for new PDFs
2. Uses OCR (POST /job/add/paperoffice_aiocr___generate, ocr_mode=complete)
   to extract text
3. Classifies into: invoice, contract, receipt, correspondence
4. Moves files to category subfolders
5. Logs results to classification_log.csv

Authenticate with: Authorization: Bearer po_ut_YOUR_API_KEY.
processing_lane=instant for a synchronous response.

Đầu cuối

Các quy trình hoàn chỉnh

Từ đầu vào đến xuất dữ liệu — mỗi bước trong cùng một lệnh nhắc.

IDP Hóa đơn → Xuất dữ liệu kế toán

Tải lên PDF → AI-IDP + Khung bao (Bounding Boxes) → Xác thực → Xuất dữ liệu CSV

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an accounts-payable pipeline:
1. Watch a folder for incoming invoice PDFs
2. Extract fields via POST /job/add/workflow (file_1,
   idp_collection=invoice, processing_lane=instant)
3. Flag every field with confidence < 0.9 for manual review,
   including its bounding box for the verification UI
   (result.pages_idp[0].suggested_fields + result.pages_aiocr)
4. Export supplier, total, date and IBAN as CSV for the accounting import

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP Hợp đồng + Cảnh báo hạn chót

Tải lên hợp đồng → Từ khóa chính → Knowledge Graph → Thông báo cảnh báo

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract analyzer:
1. Upload contracts via POST /job/add/workflow (file_1,
   idp_collection=contract, processing_lane=instant)
2. Extract parties, start date, end date and notice period
   from result.pages_idp[0].suggested_fields (each with a bounding box)
3. Store the key terms in a knowledge graph
4. Alert me 90 days before a notice period expires

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Chuyển đổi PDF — Word / PowerPoint / PDF/A

Tải lên PDF → Chọn định dạng → Chuyển đổi → Tải xuống

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a PDF converter service:
1. One pipeline per target format (field file_1):
   POST /job/add/pdfstudio___pdf_to_word | pdfstudio___pdf_to_powerpoint |
   pdfstudio___pdf_to_pdfa | pdfstudio___pdf_to_webp
2. processing_lane=instant for a synchronous response
3. Return the download URL from result ?? job_result

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Webhooks — xử lý job.completed

Đăng ký webhook → Gửi tài liệu → Nhận sự kiện → Xử lý

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a webhook event handler:
1. Register a webhook via POST /webhooks/subscribe
   (url, events: ["job.completed", "job.failed"], secret)
2. Verify the HMAC-SHA256 signature of every delivery
   with the subscription secret (see llms-full.txt, webhooks)
3. Process the payload whenever job.completed arrives

Note: webhooks always require a token (account binding).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

OCR → TTS — Tài liệu thành âm thanh

Quét OCR tài liệu → Xử lý văn bản → Tạo giọng nói (TTS) → Lưu tệp âm thanh

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document-to-audio pipeline:
1. OCR via POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
2. Split the extracted text (result ?? job_result, pages) into 5000-character chunks
3. TTS per chunk: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
   output_format=mp3, output=url, processing_lane=instant)
4. Save all returned audio URLs as a playlist

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Quét OCR hàng loạt → Xuất CSV

Quét thư mục → Quét OCR hàng loạt → Thu thập văn bản → Xuất CSV

Prompt
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a batch OCR-to-CSV exporter:
1. Scan a folder for PDF/PNG/JPG/TIFF/WEBP files
2. For each file: POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
3. Collect filename, page_count, text preview and confidence
4. Write everything to ocr_results.csv

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Bước tiếp theo

Tiếp tục với API

llms.txt và Playground — không đường vòng.

Token cho REST và MCP Phản hồi với credits_billed Cơ sở hạ tầng EU riêng
Video

Cookbook trong hành động

Xem cách PaperOffice API hoạt động trong thực tế — qua video.

Cookbook trong hành động

Câu hỏi thường gặp

Tổng hợp tất cả thông tin quan trọng

Tôi có cần SDK không?

Không. PaperOffice API là REST thuần túy: một điểm cuối, một mã thông báo Bearer, multipart/form-data. Ngoài ra, máy chủ MCP cũng được cung cấp cho các IDE và tác nhân.

Tại sao llms.txt lại xuất hiện trong mỗi prompt?

llms.txt là phiên bản có thể đọc được bằng máy của tài liệu API. Mô hình của bạn sẽ đọc từ đó các điểm cuối (endpoints), tham số và định dạng phản hồi — và không tự tạo ra các trường dữ liệu nào.

Tôi nên nhập khóa nào?

Một User Token có tiền tố po_ut_. Bạn có thể tìm thấy nó trong ứng dụng PaperOffice tại Tài khoản → API. Hãy thay thế po_ut_YOUR_API_KEY trong prompt bằng khóa của riêng bạn.

Kết quả có trả về ngay lập tức hay tôi cần phải poll (truy vấn lặp)?

Với processing_lane=instant, API sẽ phản hồi đồng bộ (HTTP 200 kèm result). Nếu không có tham số này, hệ thống sẽ trả về HTTP 202 kèm job_id; bạn có thể lấy kết quả qua GET /job/get/{job_id} hoặc webhook.

Các prompt có hoạt động trong mọi môi trường không?

Các prompt không chứa các hướng dẫn phụ thuộc vào công cụ cụ thể. Đã được kiểm tra với Claude, Claude Code và Cursor — bất kỳ môi trường nào có khả năng đọc URL đều có thể xử lý được.

Chi phí cho một lần gọi là bao nhiêu?

Mỗi phản hồi sẽ nêu rõ credits_billed (số Credits đã tính). Giá Credits cho mỗi pipeline có trong bảng giá; bạn chỉ phải trả cho những gì thực sự được xử lý.

Quý vị muốn dùng thử PaperOffice ở đâu?

Máy tính và điện thoại thông minh đã được kết nối: Không gian làm việc trên máy, thu thập trên điện thoại.

Phiên bản dùng thử của bạn đã sẵn sàng

Bạn muốn bắt đầu ở đâu?

Không gian làm việc đầy đủ được tối ưu hóa cho máy tính. Phiên bản di động phù hợp để thu thập, kiểm tra và phê duyệt tài liệu.

app.paperoffice.ai

Bắt đầu trên máy tính

Chúng tôi sẽ gửi liên kết truy cập cá nhân của bạn đến địa chỉ email của bạn.

Đăng ký miễn phí Mở ứng dụng Ứng dụng PaperOffice Sản phẩm đầy đủ: web, máy tính và di động. Thu thập, tổ chức, tìm kiếm và làm việc trên tài liệu cùng nhóm. Cần tài khoản miễn phí Mở Playground Playground Thử các chức năng được chọn ngay — không đăng ký, với khóa API demo bị hạn chế. Không cần đăng ký, nhưng có khóa API demo bị hạn chế