Перейти до змісту
Огляд Огляд Новини Новини
Поділитися

Cookbook

Промпти для копіювання. Готові приклади API.

28 промптів для Document AI, Data APIs та IDE-робочих процесів — скопіюйте, вставте, отримайте код.

Файл llms.txt від PaperOffice читається будь-яким сучасним LLM: Claude, Cursor та ваш IDE роблять решту.

28 готових промптів Справжні кінцеві точки REST та MCP

Інтеграція

Від llms.txt до безперервної інтеграції

Три кроки: посилання на документацію, вказівка наміру, копіювання коду.

  1. Вставити llms.txt

    Вставте в Claude, Cursor або ваш IDE.

  2. Вказати намір

    Що потрібно створити — або промпт з цієї сторінки.

  3. Дозволити написання коду

    IDE забезпечує поточну інтеграцію.

Document AI

Читати, перевіряти та надсилати документи

Скопіюйте промпт, вставте його в Claude або Cursor — готово.

IDP рахунок + AI-OCR + обмежувальні рамки

Екстрагувати поля рахунку, включаючи позицію в документі.

Промпт
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 — текст з зображення/PDF

Повнотекстовий пошук через POST /job/add/paperoffice_aiocr___generate (ocr_mode=complete).

Промпт
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

Розділення PDF за допомогою ШІ — розділення об'єднаного PDF

Виявлення меж документів та найменування окремих файлів.

Промпт
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

Анонімізація документів — приховування персональних даних (PII)

Виявлення та редагування імен, IBAN, адрес.

Промпт
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

Голосове відтворення TTS — текст у аудіо

Синхронне MP3 через voice=Nadja (та ін.).

Промпт
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 Договір + ШІ-OCR + межі об'єктів

Екстрагування полів договору, включаючи позицію в документі.

Промпт
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

Електронний підпис — створення запиту на підпис

Запросити підписанта та керувати статусом/нагадуванням.

Промпт
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

Цифровий рекомендований лист — Надсилання через електронну пошту

Безпечне доставлення з паролем до PDF (електронна пошта або SMS) та журналом відправки.

Промпт
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

Дані та безпека APIs

Перевірка місця розташування, ризику та основних даних

Геозадавання, погода, відбиток, податковий номер ПДВ тощо — як промпт.

Геозадавання — Прямий / Зворотний / Автозаповнення

Адреса ↔ Координати.

Промпт
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

Погода — Поточна + Якість повітря

Поточна погода включно з билінгом.

Промпт
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 → Місце

Місцезнаходження з IP, опціонально Погода.

Промпт
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

Відбиток пристрою — ID відвідувача

ID відвідувача та впевненість.

Промпт
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

Перевірка фейкової пошти — Перевірка одноразових адрес

Одноразова пошта та рівень ризику.

Промпт
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

Перевірка VPN / Анонімності

VPN, проксі, Tor, дата-центр.

Промпт
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

Перевірка ПДВ — ідентифікатор ПДВ ЄС

Дійсність та дані компанії.

Промпт
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

Обмін валют — Живі курси

Перерахунок за поточним курсом.

Промпт
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 та інструменти ШІ

Для Claude, Cursor та вашої IDE

Промпти, що працюють у IDE — включаючи MCP-сервер.

IDP Invoice Pipeline + Bounding Boxes + CSV

Пакетне вилучення з координатами верифікації.

Промпт
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

MCP-сервер — Document AI у IDE

Підключення MCP та обробка документів із робочого простору.

Промпт
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

Голосовий агент — STT + TTS

Обробка голосового вводу та відповіді аудіо.

Промпт
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

Виявлення шахрайства — відбиток пристрою + IP

Перевірка відбитка пристрою та гео/IP-сигналів.

Промпт
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

Пакетне розділення PDF за допомогою ШІ

Асинхронне розділення великих папок з PDF-файлами.

Промпт
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

Класифікатор документів — OCR + папки

OCR, класифікація, сортування за підпапками.

Промпт
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.

Кінцевий результат

Повні конвеєри обробки

Від входу до експорту — кожен етап в одному промпті.

IDP рахунки → експорт у бухгалтерію

Завантаження PDF → AI-IDP + обмежувальні рамки → Перевірка → Експорт CSV

Промпт
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 договори + сповіщення про терміни

Завантаження договору → Ключові терміни → Knowledge Graph → Попередження

Промпт
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

Конвертер PDF — Word / PowerPoint / PDF/A

Завантаження PDF → Вибір формату → Конвертація → Завантаження

Промпт
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

Вебхуки — обробка job.completed

Реєстрація вебхука → Надсилання документа → Отримання події → Обробка

Промпт
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 — Документ у аудіо

Документ OCR → Підготовка тексту → Генерація TTS → Збереження аудіо

Промпт
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

Пакетна OCR → Експорт у CSV

Сканування папки → Пакетна OCR → Збір тексту → Експорт у CSV

Промпт
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

Наступний крок

Продовжити з API

llms.txt та Playground — без зайвих кроків.

Токен для REST та MCP Відповідь з credits_billed Власна інфраструктура в ЄС
Відео

Cookbook у дії

Подивіться, як працює PaperOffice API на практиці — у відео.

Cookbook у дії

Часті питання

Все важливе в одному місці

Чи потрібен мені SDK?

Ні. PaperOffice API — це чистий REST: одна точка доступу, токен Bearer, формат multipart/form-data. Для IDE та агентів також доступний сервер MCP.

Чому файл llms.txt відображається в кожному промпті?

Файл llms.txt є машинозчитуваною версією документації API. Ваша модель зчитує з нього кінцеві точки, параметри та формати відповідей — і не вигадує жодних полів.

Який ключ я повинен ввести?

Введіть токен користувача з префіксом po_ut_. Ви можете знайти його у додатку PaperOffice за шляхом Account → API. Замініть po_ut_YOUR_API_KEY у промпті на свій власний ключ.

Чи надходить результат миттєво, чи потрібно використовувати опитування (polling)?

З параметром processing_lane=instant система API відповідає синхронно (HTTP 200 з результатом). Без цього параметра повертається HTTP 202 з job_id; результат можна отримати через GET /job/get/{job_id} або за допомогою вебхука.

Чи працюють промпти в будь-якому середовищі?

Промпти не містять інструкцій, специфічних для певних інструментів. Перевірено з Claude, Claude Code та Cursor — будь-яке середовище, яке може читати URL, впорається з ними.

Скільки коштує один запит?

У кожній відповіді вказується credits_billed. Ціни на Credits для кожної конвеєрної лінії (pipeline) наведені у таблиці цін; нараховується лише те, що було фактично оброблено.

Де ви хочете спробувати PaperOffice?

Комп'ютер і смартфон підключені: робочий простір на комп'ютері, захоплення на телефоні.

Ваша пробна версія готова

З чого ви хочете почати?

Повний робочий простір оптимізовано для комп'ютера. Мобільна версія підходить для захоплення, перевірки та затвердження документів.

app.paperoffice.ai

Почати на комп'ютері

Ми надішлемо ваше особисте посилання для входу на електронну пошту.

Зареєструватися безкоштовно Відкрити застосунок Застосунок PaperOffice Повний продукт: веб, комп’ютер і мобільні пристрої. Захоплюйте, організовуйте, шукайте документи та працюйте з ними разом із командою. Потрібен безкоштовний обліковий запис Відкрити Playground Playground Вибрані функції одразу — без реєстрації, з обмеженим демо-ключем API. Без реєстрації, але з обмеженим демо-ключем API